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Interacting with tTuTComputer using Speech 
Input and Speech Output 

Note: This documentation is preliminary and is subject to change. 

This topic is a basic introduction to the System. Speech namespace in WinFX. 

Interacting with the Computer using Speech Input and Speech 
Output 

Humans prefer to communicate with each other using speech, because of its ease of use and 
• expressiveness. Microsoft is extending this metaphor to human-computer interaction. Our goal is to 
make the use of speech a viable way of interacting with Microsoft Windows. This will primarily benefit 
those users who rely on assistive technologies to interact with the computer, but is not limited to these 
users. 

In order to achieve this goal, Microsoft is pursuing a two-pronged strategy: 

• Enable common speech scenarios out of the box. 

• Provide a managed API to customize and extend the speech experience. 

In this document we use the terms speech recognition and speech synthesis, which are commonly used 
in the industry. The popular press sometimes uses the terms voice recognition and voice output to refer 
to the same technologies. 

Overview of Speech Recognition 

Speech recognition is the process of converting audio into text. Speech recognition systems are based on 
algorithms that model human speech, both the sounds that make up a language as well as the word 
sequences that are commonly used. They use digital signal processing methods and powerful search 
algorithms to determine the sequence of words the user spoke. The diagram below shows the major 
components of a speech recognition system. 



x] Conceptual 



The acoustic models are provided by the speech recognition sub-system (SR engine). They express the 
way humans pronounce the basic units of speech (phonemes) in a given language. The SR engine comes 
pre-configured with models which are averaged over a large set of speakers, male and female, of a given 
language. In order to get better recognition performance the models are trained on the user's machine. 
Training is done explicitly via a training wizard, or implicitly by observing the user. 

The language model describes in a statistical fashion the likelihood of specific word sequences occurring 
at a given time. In other words, what is the probability of the word "America" following the words 
"United States of? These statistics are determined by analyzing a large collection of written and spoken 
text. Because of their statistical nature, they are flexible - any word sequence has some, albeit small, 
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probability of occurring - but lack the rigor required for high recognition accuracy. 

Grammars on the other hand explicitly define all the allowable word sequences for a given recognition. 
They are commonly expressed as context-free grammars (CFGs) or finite-state machines (FSM). While 
lacking the flexibility of language models - not all word sequences are allowed - they tend to result in 
higher recognition accuracy. Because they are specific to an application, or an application state, they 
have to be authored by the application developer or a team member proficient in creating context-free 
grammars. They can be expressed using a standardized markup language, and/or programmatically 
through the use of objects in the System.Speech.Srgs namespace. 

The following list shows some strengths of speech recognition technology: 

• Speech recognition technology is natural. We can express what we want the computer to do rather 
than breaking a task down into individual steps for mouse or keyboard execution. 

• Speech recognition technology is efficient. Most people can talk much faster than they can type. 

• Speech recognition technology is good at referring to items that are not on visible on the screen, 
and so cannot be selected or clicked using the mouse or keyboard. 

• Speech recognition technology is flexible. Developers can create parameterized voice macros. 

The following list shows some weaknesses of speech for interacting with the computer: 

• Speech recognition technology is not effective for fine positioning of the cursor. The mouse or 
keyboard are much more accurate. 

• Using speech recognition technology might result in some lack of privacy. Others in the vicinity 
can overhear us speaking to a computer. 

Overview of Speech Synthesis 

Speech synthesis or text-to-speech (TTS) is the process of converting written text into audio. The text 
(expressed as a basic string that can contain standardized XML-based markup) is normalized by the TTS 
engine (the text "23" is converted into the words "twenty three") and used to generate a waveform using 
a particular voice. A voice describes how the basic units of speech are to be realized as waveform 
fragments, which is concatenated by the TTS engine into a single waveform. Speech Synthesis Markup 
Language (SSML) can be used to change the prosody of the speech. For example, emphasizing the word 
tomorrow in the phrase "I want to fly to Seattle tomorrow". 

Speech in f Longhorn ? 

As mentioned above, Microsoft is taking a two-pronged approach to creating a compelling speech 
interaction model for Windows: 

• the common speech scenarios, like speech-enabling menus and buttons, will be enabled system- 
wide by Microsoft. 

• a comprehensive set of managed APIs that follow the WinFX design guidelines allows the 
developer to extend the basic functionality with application-specific speech commands and 
behaviors. For example, providing voice shortcuts for common context-sensitive commands. 

The last section of this article provides the code for a Hello World example demonstrating speech 
recognition and speech synthesis, and a brief description of the important parts of the application. 
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A Hello World Sample 

The main objects perforating speech recognition are located in the System.Speech.Recognition 
namespace, and the main objects performing text-to-speech, are located in the System. Speech. Synthesis 
namespace. At the top of the sample are two using directives that provide links to these namespaces. 
Note that there is also a third namespace that deals with grammars, not referenced in this sample, 
System.Speech.SRGS. 

The Hello Word sample is a Windows GUI application, which accounts for the using directive 
identifying the System. Windows. Forms namespace. 

Most of the work in this application occurs in the form's Load event handler. The first statement in the 
event handler initializes a grammar object. The second statement loads the Hello World, grxml file into 
the grammar object. The grxml file contains XML-formatted text specifying grammar rules that comply 
with the World Wide Web Consortium Speech Recognition Grammar Specification Version 1 .0 (W3C 
SRGS). 

The next statement in the form Load event handler registers an event handler for the Recognition event. 
The Recognition event is raised in a speech application whenever a successful recognition occurs. In the 
Hello World sample, find the Recognition event handler right after the form Load event handler. One of 
the event parameters, the RecognitionEventArgs object, provides data for the Recognition, 
RejectedRecognition, and Hypothesis events. 

Look at this statement in particular: v.Speak( M You said" + e.Result.Text); 

The Result property in this statement returns a RecognitionResult object, which represents the result of 
the recognition. The Text property of this object contains a concatenation of the spoken words. 

The previous statement in the Recognition event handler created a Voice object, v, and in this statement 
v uses speech synthesis to speak back the recognized phrase, prefaced by the two words "you said. 1 ' 

Code for the Hello World Sample 

using System; 

using System. Windows . Forms ; 
using System. Speech .Recognition; 
using System. Speech . Synthesis ; 

namespace Microsoft . Speech . HelloWorld 

{ 

// SpeechRecognition is a WinForm application 
// that demonstrates basic speech recognition 
// and speech synthesis functionalities 
public class SpeechRecognition : Form 

{ 

// The main entry point for the application. 
[STAThread] 
static void Main() 

{ 

Application. Run (new SpeechRecognition ( ) ) ; 

} 

// Initializes SpeechRecognition form. 
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public SpeechRecognition () 

{ 

InitializeComponent () ; 

} 

protected override void Dispose ( bool disposing ) 

{ 

// Wizard-generated code not shown 

} 

.// Main form load method 

private void SpeechRecognition_Load (object sender, EventArgs e) 

{ 

// Create grammar object that will hold the CFG 
Grammar g = new Grammar (); 

// Load SRGS file containing the HelloWorld grammar 
g. Load ( "HelloWorld. grxml") ; 

// Set up the recognition event handler 
g. Recognition += 

new RecognitionEventHandler (RecognitionEverit) ; 

// Tell the recognizer to start listening for 
// phrases specified in HelloWorld. grxml 
g.IsActive = true; 

} 

// Speak the text of what was recognized 

private void RecognitionEvent (obj ect s, RecognitionEventArgs e) 

{ 

Voice v = new Voice () ; 

v.SpeakC'You said 11 + e . Result . Text) ; 

} 

#region Windows Form Designer generated code 

} 



Conclusion 



Microsoft intends to make speech a much more appealing way of interacting with Microsoft Windows. 
To further that goal, "Longhorn" will support a number of common speech scenarios for free. In 
addition, "Longhorn" will include a managed API which will allow developers to customize and extend 
the speech experience. This article provides an introduction to speech technology, and the Speech 
namespaces in "Longhorn." 
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Note: This documentation is preliminary and is subject to change. 
The following table lists the namespaces available for WinFX. 
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~ , ^ . . The following tables list the members exposed by the 
System. Speech.Recognition 0 . o u r» 
_v ^ & System. Speech.Recogmtion namespace. 

c c - c The following tables list the members exposed by the 

bystem.bpeesh.brgs System.Speech.Srgs namespace. 

o „ « 0 The following tables list the members exposed by the 

System. Speech. Synthesis a , 0 °, c - • 
— * * System.Speech.Synthesis namespace. 
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SystenioSpeechoRecognition 



Note: This documentation is preliminary and is subject to change. 

The following tables list the members exposed by the System. Speech.Recognition namespace. 



Classes 



ActiveCategoryChangedEventArgs 

AudioContentChangedEventArgs 
BookmarkEventArgs 

Category 

CommandRecognitionEventAr gs 
DictationGrammar 

Dis playToken 

Display TokenCollection 
Grammar 

GrammarCollection 
InterferenceEventArgs 

LocalRecognizer 



RecognitionAudio 

RecognitionEventArgs 
RecognitionPhrase 



Provides data for the 

ActiveCategoryChangedEventArgs event. 

Provides data for the AudioContentChanged event. 

Provides data for the BookmarkReached event. 

Represents a type of recognition of a speech 
synthesis resource. 

Provides data for the CommandRecognition event 
in the Command and CommandSet objects. 

Contains individual rules and dictation grammars. 

Represents a token, in western languages this is 
typically a word ? that was recognized by the speech 
recognizer. 

Represents a collection of recognized tokens. 

The Grammar class is a logical housing for 
individual recognition rules and dictation grammars 

Represents a collection of Grammar objects. 

Provides data for the Interference event. 

This class allows applications to create a private 
instance of a Recognizer in their own address 
space. 

Contains the audio data and methods for a specific 
RecognitionResult or a portion of a 
RecognitionResult 

Provides data for the Recognition, 
RejectedRecognition, and Hypothesis events. 

Represents the phrase that was recognized by the 
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Reco gni tionPhraseAlternate 
RecognitionPhraseAlternateCollection 

RecognitionResult 

RecognitionRule 

RecognitionRuleCollection 

RecognizeCompletedEventArgs 

RecognizeProgressChangedEventArgs 

RecognizerAttributes 

RecognizerProperties 
Recognizers 

RecognizerStateChangedEventArgs 
Rule 

RuleCollection 

SemanticProperty 

SemanticPropertyCollection 

SpeechEventArgs 

SpokenToken 

SpokenTokenCollection 

SystemRecognizer 

UpdateEventArgs 



recognizer. 

Contains information about an alternate recognition 
by the speech recognizer. 

A collection of alternatives for a specific result. 

Represents the result when a speech recognizer 
processes audio and attempts to recognize user 
speech. 

Represents the rule that allowed the associated 
result to be recognized. 

Provides a collection of rules. 

Provides event arguments for the 
RecognizeCompleted event. 

Provides data for the RecognizeProgressChanged 
event. 

Represents the attributes various speech recognizers 
may, or may not support. 

Represents recognizer properties that are adjustable 
at runtime. 

Represents a collection of speech recognizers. 

Provides data for the RecognizerStateChanged 
event. 

Represents a grammar rule. 

Represents a collection of Rules. 

Represents a single semantic property that may 
contain additional levels of semantic information. 

Represents a collection of semantic properties. 

Provides data for these events: NoRecognition, 
AudioLevelChanged, RecognitionStarted, 
RecognitionStopped, RecognitionCanceled, 
RecognitionPaused, and RecognitionResumed. 

Represents a token, in western languages this is 
typically a word , that was recognized by the 
speech recognizer. 

Represents a collection of recognized tokens. 
Represents the shared recognizer. 
Provides data for the Update event. 



Interfaces 



IRecognizer Provides an interface representing a speech recognizer. 



Enumerations 



AdaptationRelevance Specifies an estimate of the language model data relevance. 
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AdaptationSettin gs 

AudioContent 

Confidence 

InterferenceTyp e 

LeadingSpace 

RecognizeMode 
RecognizerState 
ResultType 

TrailingSpace 



Specifies the options to use with the AdaptLanguageModel method 
to control the language model adaptation process. 
Specifies the current audio state. 

Specifies the various high level confidence values possible for 
speech recognition. 

Specifies the types of interference in the audio input preventing an 
optimal speech recognition experience. 
Specifies how to handle leading space when incorporating 
RecognitionResult text into surrounding text. 

Specifies the recognition mode. 

Specifies the current state of the recognizer. 

Specifies the types of recognition result that can be sent. 

Specifies how to handle trailing space when incorporating the 

RecognitionResult's text into surrounding text. 



Structures 



DictationTopic Represents a dictation topic. 



Delegates 



ActiveCategoryChangedEventHandler 
AudioContentChangedEventHandler 
B ookmarkEventHandler 

CommandRecognitionEventHandler 

InterferenceEventHandler 

Reco gnitionEventHandler 

Reco gnizeCompletedEventHandler 
RecognizeProgressChangedEventHandler 
RecognizerStateChangedEventHandler 

S peechEventHandler 



Represents the method that will handle the 
ActiveCategoryChangedEventHandler event. 

Represents the method that will handle the 
AudioContentChanged event. 

Represents the method that will handle the 
Bookmark event. 

Represents the method that will handle the 
CornmandRecognition event in Command and 
CommandSet. 

Represents the method that will handle the 
InterferenceDetected event. 

Represents the method that will handle the 
following events: Recognition, 
RejectedRecognition, and Hypothesis. 

Represents the method that will handle the 
RecognizeCompleted event. 

Represents the method that will handle the 
RecognizeProgressChanged event. 

Represents the method that will handle the 
RecognizerStateChanged event. 

Represents the method that will handle the 
following events: NoRecognition, 
AudioLevelChanged, RecognitionStarted, 
RecognitionStopped, RecognitionCanceled, 
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UpdateEventHandler 



RecognitionPaused, and RecognitionResumed. 

Represents the methods that handle the Updated 
event and related events. 
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ActiveCategoryChangedEventArgs Class 



Note: This documentation is preliminary and is subject to change. 
Provides data for the ActiveCategoryChangedEventArgs event. 
Definition 

Visual Public Class ActiveCategoryChangedEventArgs 
Basic Inherits SpeechEventA rg s 
C# public class ActiveCategoryChangedEventArgs : SpeechEventArg s 

Managed public gc 

C++ class ActiveCategoryChangedEventArgs : public SpeechEventArg s 

JScript public class ActiveCategoryChangedEventArgs extends SpeechEventArgs 
Members Table 
Inheritance Hierarchy 



Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. . 



ActiveCategoryChangedEventArgs Method 



Object 



[x] Leave 



x Leave 



EventArgs I : 

SpeechEventArgs 

ActiveCategoryChangedEventArgs 
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Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the ActiveCategoryChangedEventArgs class. 
Definition 

Public Sub ActiveCategoryChangedEventArgs( _ 
Visual Basic ByVal audioPosition As TimeSpan . _ 
ByVal activeCategory As Category _ 

) 

public ActiveCategoryChangedEventArgs( 
£g TimeSpan audioPosition, 

fl Category activeCategory 

.); ^ 

public: ActiveCategoryChangedEventArgs( 
. n TimeSpan audioPosition, 
Managed C++ Category * activeCategory 

); 

public function ActiveCategoryChangedEventArgs( 
. audioPosition : TimeSpan . 

crip activeCategory : Category 

); 

Parameters 

audioPosition System.TimeSpan. Placeholder 

activeCategory System.Speech.Recognition.Category. Specifies the active category. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ActiveCategory Property 

Note: This documentation is preliminary and is subject to change. 

Gets the new active category. 

Definition 

Visual Basic Public ReadOnly Property ActiveCategory As Category 
C# public Category ActiveCategory { get; } 

Managed C++ public: property Category * get_ActiveCategory(); 

JScript public function get ActiveCategory 0 : Category 

Property Value 



r:i ~ . / //^ .\ -\i rncrv\r\x\ to\ tua /td\ . U"UT7T? a O V»+™ 



mid a 



Interacting with the Computer using Speech Input and Speech Output Page 10 of 35 / 

System.Speech.Recognition.Category. 

This property is read-only. 

© 2003 Microsoft Corporation/All rights reserved. Terms of use. 

AudioContentChangedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 
Provides data for the AudioContentChanged event. 
Definition 

Visual Public Class AudioContentChangedEventArgs 
Basic Inherits SpeechEventArg s 

C# public class AudioContentChangedEventArgs : SpeechEventArgs 

Man aged public gc 

C++ class AudioContentChangedEventArgs : public SpeechEventArgs 

JScript public class AudioContentChangedEventArgs extends SpeechEventArgs 
Members Table 
Inheritance Hierarchy 



Object 



"xj Leave 



EventArgs 



0 Leave 



S peechEventArgs 

AudioContentChangedEventArgs 



Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContentChangedEventArgs Method 
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Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the AudioContentChangedEventArgs class. 
Definition 

Public Sub AudioContentChangedEventArgs( _ 
Visual Basic ^yVal audioPosition As TimeSpan . _ 
ByVal content As AudioContent _ 

) " 

public AudioContentChangedEventArgs( 
£0 TimeSpan audioPosition, 

AudioContent content 

); 

public: AudioContentChangedEventArgs( 

, , , « , , . TimeSpan audioPosition, 
Managed C++ *; — ■ 9 
& AudioContent content 

); 

public function AudioContentChangedEventArgs( 
„ . audioPosition : TimeSpan , 

p content : AudioContent 



); 



Parameters 



audioPosition System.TimeSpan. Placeholder 

content System.Speech.Recognition.AudioContent. Updated input audio content. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Content Property 

Note: This documentation is preliminary and is subject to change. 

Gets the updated audio content. 

Definition 

Visual Basic Public ReadOnly Property Content As AudioContent ^ 
C# public AudioContent Content { get; } 

Managed C++ public: property AudioContent get ContentO; 

JScript public function get ContentO : AudioContent 

Property Value 
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System.Speech.Recognition.AudioContent. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

Provides data for the BookmarkReached event. 

Definition 

Visual Basic ^ u ^^ c Class BookmarkEventArgs 

Inherits SpeechEventArgs 

C# public class BookmarkEventArgs : SpeechEventArgs 

Managed C++ public gc class BookmarkEventArgs : public SpeechEventArgs 

JScript public class BookmarkEventArgs extends SpeechEventArgs 

Members Table 
Inheritance Hierarchy 



Object 



El Leave 



EventArgs 



3 Leave 



SpeechEventArgs 

BookmarkEventArgs 



Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkEventArgs Method 
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Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the BookmarkEventArgs class. 
Definition 

Public Sub BookmarkEventArgs( _ 
v . , ^ . ByVal audioPosition As TimeSpan , _ 
iSuai BaSIC ByVal tag As Object _ 

) 

public BookmarkEventArgs( 
^ TimeSpan audioPosition, 

object tag 

); 

public: BookmarkEventArgs( 

Manaped C++ TimeS P an audioPosition, 
Managed C++ ^ 

); 

public function BookmarkEventArgs( 
™ . audioPosition : TimeSpan , 

p tog* : Object 

); 

Parameters 

audioPosition System.TimeSpan. Placeholder 

tag System.Object. Application supplied object reference. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Tag Property 

Note: This documentation is preliminary and is subject to change. 

Gets an application-supplied object reference. 

Definition 

Visual Basic Public Readonly Property Tag As Object 
C# public object Tag { get; } 

Managed C++ public: property Object * getJTag(); 

JScript public function get Tag() : Object 

Property Value 
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System.Object. 

This property is read-only. 

© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

Category Class 

Note: This documentation is preliminary and is subject to change. 
Represents a type of recognition of a speech synthesis resource. 
Definition 

Visual Basic Class Category 

Inherits Object 

C# public class Category : Object 

Managed C++ public gc class Category : public Object 

JScript public class Category extends Object 

Members Table 
Inheritance Hierarchy 



Object 



13 Leave 



Category 

Class Information 

Namespace System. Speech.Recognition 

Assembly ' System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Note: This documentation is preliminary and is subject to change. 
Creates a new Command subcategory. . 
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Overload List 

public Category 0 

public Category (Category) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 

Note: This documentation is preliminary and is subject to change. 
Overload List 

protected virtual Void Dispose (Boolean) 
protected virtual Void Dispose () 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Finalize Method 

Note: This documentation is preliminary and is subject to change. 
Implements the actions required to destruct an instance of the Category class. 
Definition 

Visual Basic Overrides Protected Sub FinalizeO 

C# -CategoryO; 
Managed C++ -CategoryO; 

JScript protected override function FinalizeO : void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Command Property 

Note: This documentation is preliminary and is subject to change. 

Returns the predefined Command category. 

Definition 
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Visual Basic Public Shared ReadOnly Property Command As Categor y 
C# public static Categ ory Command { get; } 

Managed C++ public: property static Categ ory* get_Command(); 

JScript public static function get Command() : Category 

Property Value 

System.Speech.Recognition.Category. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dictation Property 

Note: This documentation is preliminary and is subject to change. 

Returns the predefined Dictation category. 

Definition 

Visual Basic Public Shared ReadOnly Property Dictation As Category 
C# public static Category Dictation { get; } 

Managed C++ public: property static Category * get_Dictation(); 

JScript public static function get DictationQ : Category 

Property Value 

System.Speech.Recognition.Category. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Icon Property 

Note: This documentation is preliminary and is subject to change. 
Gets or sets the icon representing the category. 
Definition 
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Visual Basic Public Property Icon As Icon 
C# public Icon Icon { get; set; } 

Managed C++ pubUc: -P 10 ^ ^on* § e Ucon(); 

s public: property void setjfcon( lcon *): 



yc • public function get IconO : Icon 
P public function set Icon( Icon ); 



Property Value 

System.Drawing.Icon. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsActive Property 



Note: This, documentation is preliminary and is subject to change. 
Gets or sets a value that specifies whether the category is enabled. 
Definition 

Visual Basic Public Property IsActive As Boolean 
C# public bool IsActive { get; set; } 

Managed C++ pubHc: —P TO V ort y ^ g^UsActiveO; 

8 public: property void set lsActive( bool) ; 

• f public function get IsActiveO : boolean 
cn P public function set IsActive( boolean ); 

Property Value 

System.Boolean. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsPrefixRequired Property 



Note: This documentation is preliminary and is subject to change. 
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Gets or sets a value that specifies whether a prefix is required to access grammars associated with the 
category. 

Definition 

Visual Basic Public Property IsPrefixRequired As Boolean 

C# public bool IsPrefixRequired { get; set; } 

r public: property bool geMsPrefixRequiredQ; 

Managed C++ public . _p roperty void S et_IsPrefixRequired(bool); 

. public function get IsPrefixRequiredO ■ boolean 
P public function set IsPrefixRequired(boolean); 

Property Value 

System.Boolean. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets the name of the category. 

Definition 

Visual Basic Public Property Name As String 
C# public string Name { get; set; } 

M*n*oPd r++ P ublic: J*°P ert y String* get_Name(); 
ivianagea c-i-r- pubHc: _p roperty void se t_Name(String*); 

to • t public function get NameO: String. 
Cnp public function set Name( String ); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Prefix Property 



Note: This documentation is preliminary and is subject to change. 

Gets or sets the prefix for accessing grammars associated with the category. 

Definition 

Visual Basic Public Property Prefix As String 

C# public string Prefix { get; set; } 

tut a ru_i. Public: _jproperty String * get_Prefix(); 
Managed C++ public . _p roperty void S et_Prefix(Strmg*); 

• f public function get PrefixO : String 
Scnpt public function set Prefix(String); 

Property Value 

System.String. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CommandRecognitionEventArgs Class 



Note: This documentation is preliminary and is subject to change. 

Provides data for the CommandRecognition event in the Command and CommandSet objects. 
Definition 

Visual Public Class CommandRecognitionEventArgs 
Basic Inherits SpeechEventArgs 
C# public class CommandRecognitionEventArgs : S peechEventArgs 

Managed public gc 

C++ class CommandRecognitionEventArgs : public SpeechEventArgs 

JScript public class CommandRecognitionEventArgs extends SpeechEventArgs 

Members Table 
Inheritance Hierarchy 
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I x Leave 



EventArgs 



3 Leave 



SpeechEventArgs 

CommandRecognitionEventArgs 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CommandRecognitionEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the CommandRecognitionEventArgs class. 
Definition 

Visual Basic Public Sub CommandRecognitionEventArgsO 

C# public CommandRecognitionEventArgsO; 
Managed C++ public: CommandRecognitionEventArgsO; 

JScript public function CommandRecognitionEventArgsO; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DictationGrammar Class 

Note: This documentation is preliminary and is subject to change. 

Contains individual rules and dictation grammars. 

Definition 

, 7 . Public Class DictationGrammar 

Visual Basic T - ^ 

Inherits (grammar 

C# public class DictationGrammar : Grammar 
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Managed C++ public gc class DictationGrammar : public Grammar 

JScript public class DictationGrammar extends Grammar 

Members Table 
Inheritance Hierarchy 





[xj Leave 


Object 





Grammar 

DictationGrammar 



Class Information 



Namespace System. Speech.Recognition 

Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DictationGrammar Method 

Note: This documentation is preliminary and is subject to change. 
Initializes the DictationGrammar class. 
Overload List 

public DictationGrammar 0 

public DictationGramma r (IRecognizer) 

public DictationGrammar (String ) 

Remarks 

The Grammar will be assigned to the default GrammarGroup for the specified Recognizer. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Load Method 

Note: This documentation is preliminary and is subject to change. 
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Loads a grammar from a stream. 
Overload List 

public override Void Load (Stream) 
public override Void Load (DictationTopic) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AllowUpdateOnRecognition Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets a value that specifies whether the recognition engine temporarily pauses recognition 
processing while the Recognition event is being processed. 

Definition 



Visual Basic Overrides Public Property AllowUpdateOnRecognition As Boolean 
C# public override bool AllowUpdateOnRecognition { get; set; } 

Mana ed C++ P u ^ c: property virtual bool get AllowUpdateOnRecognitionQ; 

public: property virtual void set_AllowUpdateOnRecognition(bool); 

. public function get AllowUpdateOnRecognitionO ' boolean 
cnp public function set AllowUpdateOnRecognition(booiean); 



Property Value 

System.Boolean. 

This property is read/write. 



Remarks 

This is useful if the application wants to change the grammar or stop the recognizer 
immediately after a recognition result is produced, before the recognizer has processed any 
additional audio. If you set it to true then very little appears different, but any grammar 
changes you make during recognition events are synchronous. By default this is false. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

PreceedingText Property 



Note: This documentation is preliminary and is subject to change. 
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Gets or sets text to insert immediately before the current selection in the document. 



Definition 



Managed C++ 



Visual Basic 
C# 



JScript 



Public Property PreceedingText As String 

public string PreceedingText { get; set; } 

public: property String * getPreceedingTextO; 

public: property void set_PreceedingText(String*); 

public function get PreceedingTextO : String 
public function set PreceedingText( String ) ; 



Property Value 

System.String. 

This property is read/write. 
Remarks 

This is used by the recognition engine'to do more accurate dictation because it knows the 
words before where the dictation is occurring. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



SelectedText Property 



Note: This documentation is preliminary and is subject to change. 



Gets or sets selected text in the document. 



Definition 



Managed C++ 



Visual Basic 
C# 



JScript 



Public Property SelectedText As String 

public string SelectedText { get; set; } 

public: property String * getJSelectedTextQ; 

public: property void set_SelectedText(Str|ng*); 

public function get SelectedTextO : String 
public function set SelectedText (String ); 



Property Value 



System.String. 



This property is 



read/write. 
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Remarks 

This property can be used to inform the engine of any selected text in the document. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SubsequentText Property 



Note: This documentation is preliminary and is subject to change. 

Gets or sets text to insert immediately after the current selection in the document. 

Definition 

Visual Basic Public Property SubsequentText As String 
C# public string SubsequentText { get; set; } 

Managed C++ pubHc: _P ro P ert y String* get_SubsequentText(); 

8 public: property void set_SubsequentText(Strmg*); 

|e • f public function get SubsequentText() : String 
P public function set SubsequentText(String); 

Property Value 

System.String. 

This property is read/write. 
Remarks 

This is used by the recognition engine to do more accurate dictation because it knows the 
words after where the dictation is occurring. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Topic Property 

Note: This documentation is preliminary and is subject to change. 

Gets the current dictation topic. 

Definition 

Visual Basic Public ReadOnly Property Topic As DictationTop ic 
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. C# public DictationTop ic Topic { get; } 

Managed C++ public: property DictationTop ic get_Topic(); 

JScript public function get TopicQ : DictationTop ic 

Property Value 

System.Speech.Recognition.DictationTopic. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DisplayToken Class 

Note: This documentation is preliminary and is subject to change. 

Represents a token, in western languages this is typically a word, that was recognized by the speech 
recognizer. 

Definition 



v m- P u blic Class DisplayToken 
visual J5asic T •• . 

Inherits Object 

C# public class DisplayToken : Object 

Managed C++ public gc class DisplayToken : public Object 

JScript public class DisplayToken extends Object 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



DisplayToken 

Class Information 

Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name ' PublicKeyToken-365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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ToString Method 

Note: This documentation is preliminary and is subject to change. 

Gets the display text of the token. 

Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO • String ; 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Audio Property 

Note: This documentation is preliminary and is subject to change. 
Gets the captured audio that corresponds to this recognized token. 
Definition 

Visual Basic Public ReadOnly Property Audio As RecognitionAudio 
C# public RecognitionAndio Audio { get; } 

Managed C++ public: property Recognition Au dio * get_Audio(); 

JScript public function get AudioO : RecognitionAudio 

Property Value 

System.Speech.Recognition.RecognitionAudio. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

LeadingSpace Property 
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Note: This documentation is preliminary and is subject to change. 

Gets the leading space requirements for this token. 

Definition 

Visual Basic Public Readonly Property LeadingSpace As LeadingSpace 
C# public LeadingSpace LeadingSpace { get; } 

Managed C++ public: property LeadingSpace get_LeadingSpace(); 

JScript public function get LeadingSpaceQ : Leading S pace 

.Property Value 

System.Speech.Recognition.LeadingSpace. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

SpokenTokens Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of tokens that that was recognized by the speech recognizer. 

Definition 

Visual Basic Public ReadOnly Property SpokenTokens As SpokenTokenCollection 
C# public SpokenTokenCollection SpokenTokens { get; } 

Managed C++ public: property SpokenTokenCollection * getSpokenTokensO; 

JScript public function get SpokenTokensO : SpokenTokenCollection 

Property Value 

System.Speech.Recognition.SpokenTokenCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 
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Note: This documentation is preliminary and is subject to change. 

Gets the display text of the token. 

Definition 

Visual Basic Public ReadOnly Property Text As String 
C# public string Text { get; } 

Managed C++ public: property String * get_Text(); 

JScript public function get Text() : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TrailingSpace Property 

Note: This documentation is preliminary and is subject to change. 

Gets the trailing space requirements for this token. 

Definition 

Visual Basic Public ReadOnly Property TrailingSpace As TrailingSpace 
C# public TrailingSpace TrailingSpace { get; } 

Managed C++ public: property TrailingSpace get_TrailingSpace(); 

JScript public function get TrailingSpace() : TrailingSpace 

Property Value 

System.Speech.Recognition.TrailingSpace. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DisplayTokenCollection Class 
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Note: This documentation is preliminary and is subject to change. 

Represents a collection of recognized tokens. 

Definition 



Visual B^sic ^ u ^^ c Class DisplayTokenCollection 

a a Inherits ReadOnlyColiectionBase 



C# public class DisplayTokenCollection : ReadOnlyColiectionBase 

Managed public gc 

C++ class DisplayTokenCollection : public ReadOnlyColiectionBase 

JScript public class DisplayTokenCollection extends ReadOnlyColiectionBase 



Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



ReadOnly Collecti onB as e 



fxj Leave 



DisplayTokenCollection 

Class Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0 5 Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetAlternates Method 

Note: This documentation is preliminary and is subject to change. 

Gets a collection of alternates specified by a range of tokens in the result. 

Overload List 

public RecognitionPhraseAlternateCollection GetAlternates (Int32, Int32) 
public RecognitionPhraseAlternateCollection GetAlternates (Int32, Int32. Int32) 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

GetAudio Method 

Note: This documentation is preliminary and is subject to change. 

Gets the captured audio that corresponds to the specified range of tokens in this coiiection. 
Definition 

Public Function GetAudio( _ 
Vim a l n^ic VyVd firstToken As Integer , _ 
v isuai tfasic By VaJ COU7i tOfTokens As Integer _ 

) As RecognitionAudio 

public RecognitionAudio GetAudio( 

P« int first Token, 

tat countOfTokens 

); 

public: RecognitionAudio * GetAudio( 

Managed C++ ^ fintT ^\ 

to int countOJT okens 

); 

public function GetAudio( 
JScript firstToken : int, 

p countOfTokens : tat 

) : RecognitionAudio ; 

Parameters 

firstToken System.Int32. The first token to consider 
countOfTokens System.Int32. The number of tokens to consider 

Return Value 

System.Speech.Recognition.RecognitionAudio. 

An instance of the RecognitionAudio class that represents the captured audio 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetText Method 



Note: This documentation is preliminary and is subject to change. 
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Gets the text that the specified range of tokens represents. 
Definition 



Public Function GetText( _ 
„ , ~ . . ByVal firstToken As Integer. 

Visual Basic r> t 7 / +r\rr l at* 

By Val countOfi okens As Integer 
) As String 

public string GetText( 

£0 int firstToken 9 

rt int countOfT okens 

); 

public: String * GetText( 

Managed C++ M / irStT °j^\ 

& int countOfT okens 

); 

public function GetText( 
T<s " t firstToken : int, 

^ countOfTokens : int 

) : String; 



Parameters 



firstToken System.Int32. The first token to consider 
countOfTokens System.Int32. The number of tokens to consider 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Audio Property 



Note: This documentation is preliminary and is subject to change. 

Gets the captured audio that corresponds to this collection of recognized tokens. 



Definition 



Visual Basic Public ReadOnly Property Audio As RecognitionAudio 
C# public Recognition Au dip Audio { get; } 

Managed C++ public: property RecognitionAudio * get_Audio(); 

JScript public function get AudioQ - RecognitionAudio 
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Property Value 

System.Speech.Recognition.RecognitionAudio. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 



Note: This documentation is preliminary and is subject to change. 

Gets the token at the specified position. 

Definition 

Public Readonly Property Item( _ 
Visual Basic ByVal index As Integer _ 
) As DisplayToken 

public DisplayToken this[ 
C# int index 

]{get;} 

public: property DisplayToken * get_Item( 

Managed C++ int index 

); 

JScript In JScript, you can use indexed properties, but you cannot define your own. 

Property Value 

System.Speech.Recognition.DispIayToken. 

This property is read-only. 
Parameters 

index System.Int32. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

LeadingSpace Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the leading space requirements for this fragment of text. 
Definition 

Visual Basic Public ReadOnly Property LeadingSpace As Leading Space 
C# public LeadingSpace LeadingSpace { get; } 

Managed C++ public: property LeadingSpace get_LeadingSpace(); 

JScript public function get LeadingSpaceO : LeadingSpace 

Property Value 

System.Speech.Recognition.LeadingSpace. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 
Gets the text that this collection of token represents. 
Definition 

Visual Basic Public ReadOnly Property Text As String 
C# public string Text { get; } 

Managed C++ public: property String * get_Text(); 

JScript public function get Text() : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TrailingSpace Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the trailing space requirements for this fragment of text. 
Definition 

Visual Basic Public ReadOnly Property TrailingSpace As TrailingSpace 
C# public Trailing S p ace TrailingSpace { get; } 

Managed C++ public: property TrailingSpace getJTrailingSpace(); 

JScript public function get TraiiingSpace() : TrailingSpace 

Property Value 

System.Speech.Recognition.TrailingSpace. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Grammar Class 

Note: This documentation is preliminary and is subject to change. 

The Grammar class is a logical housing for individual recognition rules and dictation grammars 
Definition 

Public Class Grammar 
Visual Basic Inherits Object 

Implements /Disposable 

public class Grammar : Object 
C * IDisposable 

* r> , , public gc class Grammar : public Object , 
Managed C++ P 

• f public class Grammar extends Object 
n P implements IDisposable 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



Grammar 

Pi ctationGramm ar 
SrgsGrammar 
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Class Information 

Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 



Note: This documentation is preliminary and is subject to change. 

Overload List 

protected virtual Void Dispose ^Boolean) 
protected virtual Void Dispose 0 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Finalize Method 



Note: This documentation is preliminary and is subject to change. 

Releases unmanaged resources and performs other cleanup operations before this instance of the 
Grammar class is reclaimed by garbage collection. 

Definition 

Visual Basic Overrides Protected Sub FinalizeO 

C# ~Grammar(); 
Managed C++ ~Grammar(); 

JScript protected override function FinalizeO • void : 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Grammar Method 



Note: This documentation is preliminary and is subject to change. 
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Initializes a new instance of the Grammar class. 
Overload List 

public Grammar () 
public Grammar (String) 
public Grammar (IRecognizer) 

Remarks 

The Grammar will be assigned to the default GrammarGroup for the specified Recognizer. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Load Method 

Note: This documentation is preliminary and is subject to change. 
Loads a grammar from the specified source URL 
Overload List 

public virtual Void Load (String) 
public virtual Void Load (Stream) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AllowUpdateOnRecognition Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets a value that specifies whether the recognition engine will pause its recognition processing 
while the Recognition event is being processed. 

Definition 

Visual Basic Overridable Public Property AllowUpdateOnRecognition As Boolean 
C# public virtual bool AllowUpdateOnRecognition { get; set; } 

Mana ed C++ P u ^^ c: property virtual bool get_AUowUpdateOnRecognition(); 

g public: property virtual void set_AllowUpdateOnRecognition( bool ); 

. public function get AllowUpdateOnRecognitionO " boolean 
c p public function set AllowUpdateOnRecognition( boolean ): 
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Property Value 

System.Boolean. 

This property is read/write. 
Remarks 

Setting this property to true causes the engine to temporarily pause its recognition 
processing while the Recognition event is being processed. This is useful if the application 
wants to change the grammar or stop the recognizer immediately after a recognition result is 
produced, before the recognizer has processed any additional audio. If you set it to true then 
very little appears different, but any grammar changes you make during recognition events 
are synchronous. By default this is false. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



BaseUri Property 



Note: This documentation is preliminary and is subject to change. 



Gets or sets a base URI from which relative paths to rulerefs can be resolved. 



Definition 



Managed C++ 



Visual Basic 

. C# 



JScript 



Public Property BaseUri As String 

public string BaseUri { get; set; } 

public: property String * get_BaseUri(); 

public: property void set_BaseUri( String *); 

public function get BaseUri0 : String 
public function set BaseUri (String ); 



Property Value 



System.String. 



This property is 



read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Category Property 



Note: This documentation is preliminary and is subject to change. 
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Gets or sets the category the grammar is associated with. 
Definition 

Visual Basic Public Property Category As Category 
C# public Category Category { get; set; } 

Managed C++ pU ™ C: -P™^ Category* get.CategoryO; 

6 public: property void set Categoryl Category* ); 

• i public function get Category() : Category 
crip public function set Category (Category ); 

Property Value 

System.Speech.Recognition.Category. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsActive Property 

Note: This documentation is preliminary and is subject to change. 
Gets or sets a value that specifies whether the grammar is active or not. 
Definition 

Visual Basic Public Property IsActive As Boolean 
C# public bool IsActive { get; set; } 

M ana ed C++ P u ^^ c: P ro P ert y bool get_IsActive(); 

" public: property void set_IsActive(booI); 

• f public function get IsActive() : boolean 
crip public function set IsActive(boolean); 

Property Value 

System.Boolean. 

This property is read/write. 
Remarks 

For a rule to be recognized, it has to be top level, it has to be active, and it has to be housed 
in an active grammar. 
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© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

ListTextBuffer Property 

Note: This documentation is preliminary and is subject to change. . 

Like the TextBuffer, this is used with the <textbuffer> element to allow a user to speak a sub-string of 
text. This field is different because any sub-string of an array of strings can be spoken. 

Definition 

Visual Basic Public Property ListTextBuffer As String Q 

C# public stdng[] ListTextBuffer { get; set; } 

iVT*n»oAH r++ pubhc: property String* get_ListTextBuffer(); 
ivianagea l-m- pubUc: _p roperty void S et_ListTextBuffer(String*); 

TQ . public function get ListTextBufferO : String [] 
Jbcnpt public set ListTextBuffer(Strmg[]); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets the name of a grammar contained in a GrammarGroup or RecognitionResults. 
Definition 

Visual Basic Public Property Name As String 
C# public string Name { get; set; } 



Managed C++ public: -J^P^ String* get_Name(); 

5 public: property void set_Name(String*); 

. public function get Name() : String 
cn P public function set Name( String ); 



Property Value 
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System.String. 

This property is read/write. 
Remarks 

Each grammar has a name. This name can be used to identify a grammar in its containing 
GrammarGroup and in RecognitionResults 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognizer Property 

Note: This documentation is preliminary and is subject to change. 
Gets or sets the speech recognizer that hosts this grammar. 
Definition 

Visual Basic Public Property Recognizer As IRecognizer 
C# public IRecognizer Recognizer { get; set; } 

Mana ed C++ P u ^^ c: P ro P ert y IRecognizer * get_Recognizer(); 

** public: property void set_Recognizer( IRecognizer *); 

T c • f public function get RecognizerO : IRecognizer 
p public function set Recognizer (IRecognizer); 

Property Value 

System.Speech.Recognition.IRecognizer. 

This property is read/write. 
Remarks 

. If a recognizer is not already set when the property's get accessor is called, a new recognizer 
will be created. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RootRule Property 

Note: This documentation is preliminary and is subject to change. 
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Gets the root rule of the grammar. 
Definition 



Visual Basic Public ReadOnly Property RootRuIe As Rule 
C# public Rule RootRuIe { get; } 

Managed C++ public: property Rule* get_RootRule(); 

JScript public function get RootRuleQ : Ruie 

Property Value 

System.Speech.Recognition.Rule. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



SharingUri Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets a name to use in rulerefs when referencing this grammar from other grammars. 



Definition 



Visual Basic Public Property SharingUri As String 
C# public string SharingUri { get; set; } 

Managed C++ public: — P ro P ert y String* get_SharingUri(); 

8 public: property void set_SharingUri(String*); 

to • f public function get SharingUriO : String 
n P public function set SharingUri( String ); 

Property Value 

System.String. 

This property is read/write. 
Remarks 

Setting this property allows grammars that are dynamically built or edited to be referenced 
in rulerefs. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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TextBuffer Property 

Note: This documentation is preliminary and is subject to change. 
Gets or sets the text from which a sub-range can be selected. 
Definition 

Visual Basic Public Property TextBuffer As String 
C# public string TextBuffer { get; set; } 

M»n»opri r++ P ubUc: -property String* getJTextBufferO; 
managed ^ ^ roperty void S etjrextBuffer(Strifig*); 

public function get TextBufferO : String 
^ crip public function set TextBuffer (String); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TopLevelRules Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of rules contained by this instance of the Grammar class. 

Definition 

Visual Basic Public ReadOnly Property TopLevelRules As RuleCollection 
C# public RuleCollection TopLevelRules { get; } 

Managed C++ public: property RuleCollection * get_TopLevelRules(); 

JScript public function get TopLevelRulesQ : RuleCollection 

Property Value 

System.Speech.Recognition.RuleCollection. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Hypothesis Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is partially recognized. 
Definition 

Visual Basic Public Event Hypothesis As RecognitionEventHandler 
C# public event RecognitionEventHandler Hypothesis; 

Managed C++ public: event Hypothesis; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

The application may use this event to display intermediate recognition results to the user. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

NoRecognition Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when a spoken phrase is not recognized. 

Definition 

Visual Basic Public Event NoRecognition As RecognitionEventHandler 
C# public event RecognitionEventHandler NoRecognition ; 

Managed C++ public: event NoRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

Handle this event to indicate to the user that the spoken phrase was unrecognized. The 
Result object in the event args will be null. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Recognition Event 



Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is successfully recognized. 
Definition 

Visual Basic Public Event Recognition As RecognitionEventHandler 
C# public event RecognitionEventHandler Recognition; 

Managed C++ public: event Recognition; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

The audio position and recognition result can be accessed through the 
RecognitionEventArgs parameter. 



© 2QQ3 Microsoft Corporation. All rights reserved. Terms of use. 

RejectedRecognition Event 



Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is recognized with low confidence. 
Definition 

Visual Basic Public Event RejectedRecognition As RecognitionEventHandler 
C# public event RecogfiitionEventHandler RejectedRecognition; 

Managed C++ public: event RejectedRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

The application should confirm the recognition result with the user before processing this 
event as a successful recognition. The audio position and recognition result can be accessed 
through the RecognitionEventArgs parameter. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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GrammarCollection Class 



Note: This documentation is preliminary and is subject to change. 

Represents a collection of Grammar objects. 

Definition 

Public Class GrammarCollection 
Visual Basic Inherits Object 

Implements I Collection . IEnumerable . IList 

public class GrammarCollection : Object . 
ICollection . Enumerable , IList 

public gc class GrammarCollection : public Object 

Managed C++ iCollection . Enumerable , IList 

• f public class GrammarCollection extends Object 
P implements IList . ICollection . IEnumerable 

Members Table 
Inheritance Hierarchy 



Object 



[x] Leave 



GrammarCollection 

Class Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral> 
Name PublicKeyToken=365 1 43bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Add Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new Grammar with the specified name to the collection. 
Overload List 
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public Grammar Add (String) 

public Grammar Add 0 

public Grammar Add (Grammar) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Clear Method 



Note: This documentation is preliminary and is subject to change. 

Removes all objects from the collection. 

Definition 

Visual Basic Public Sub ClearO 
C# public void ClearQ; 
Managed C++ public: void ClearO; 

JScript public function ClearQ • void; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Contains Method 



Note: This documentation is preliminary and is subject to change. 
Determines whether the collection contains a specific grammar. 
Definition 

Public Function Contains( _ 
Visual Basic ByVal grammar As Grammar _ 
) As Boolean 

public bool Contains( 
C# Grammar grammar 

); 

public: bool Contains( 
Managed C++ Grammar * grammar 

); 

public function Contains( 
JScript grammar : Grammar 
) : boolean ; 
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Parameters 

System.Speech.Recognition.Grammar. The grammar to locate in the 
grammar „ 
a collection. 

Return Value 

System.BooIean. True if the grammar is found in the collection; otherwise, false. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CopyTo Method 

Note: This documentation is preliminary and is subject to change. 

Copies the elements of the collection to an array, starting at the specified index in the array. 
Definition 

Public Sub CopyTo(_ 

Visual Basic ByVala^As A^^ 
ByVal index As Integer _ 

) 

public void CopyTo( 
OH Array array, 

int index 

); 

public: void CopyTo( 

Managed C++ Ans^ array, 
to mt index 

); 

public function CopyTo( 

JScript "™y: 

r index : int 

) : void : 

Parameters 

System.Array. The one-dimensional array that is the destination of the elements 

arrav 

J copied from the collection. The array must have zero-based indexing. 
index System.Int32. The zero-based index in the array at which copying begins. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



^io^/r^A^nrxTnnwQ\T^A/fP\_v»Vi-pr^AQ ht™ 973/04 



Interacting with the Computer using Speech Input and Speech Output Page 48 of 357 



GetEnumerator Method 



Note: This documentation is preliminary and is subject to change. 

Returns a System.CollectionsiEnumerator-implemented object that contains all Grammar objects within 
the GrammarCollection. 

Definition 

Visual Basic Public Function GetEnumeratorO As lEnumerator 

C# public lEnumerator GetEnumeratorO; 
Managed C++ public: lEnumerator * GetEnumeratorO; 

JScript public function GetEnumeratorO : lEnumerator : 

Return Value 

System.Collections.IEnumerator. 

A System.Collections.IEnumerator-implemented object that contains all Grammar objects 
within the GrammarCollection. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IList.Add Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Private Function IList Add( _ 
Visual Basic ByVal value As Object _ 
) As Integer 

private int IList. Add( 
C# object value 

); 

private: int IList. Add( 
Managed C++ Object* value 

); 

private function IList.Add( 
JScript value : Object 
) : int; 

Parameters 
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value System.Object. 
Return Value 

System.Int32. 



© 2003 Microsoft Corporation. All ri g hts reserved. Terms of use. 

XList.Contains Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Private Function EList.Contains( _ 
Visual Basic ByVal value As Object _ 
) As Boolean 

private bool IList.Contains( 
C# object value 

); 

private: bool IList.Contains( 
Managed C++ Object * value 

); 

private function IList.Contains( 
JScript value : Object 
) : boolean : 

Parameters 

value System.Object. 
Return Value 

System.Boolean. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IListlndexOf Method 



Note: This documentation is preliminary and is subject to change 
Definition 
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Private Function IList.IndexOf( 
Visual Basic ByVal value As Object _ 
) As Integer 

private int IList.IndexOf( 
C# object value 

); 

private: int IList.IndexOf( 
Managed C++ Object * value 

); 

private function EList.IndexOf( 
JScript value : Object 
) :int; 

Parameters 

value System.Object 
Return Value 

System.Int32. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IList.Insert Method 



Note: This documentation is preliminary and is subject to change. 
Definition 



Visual Basic 



C# 



Private Sub IList.Insert( _ 

ByVal index As Integer . _ 
By Val value As Object _ 

) 

private void IListInsert( 
int index, 
obj ect value 

); 

private: void IList.Insert( 

j g~y . . int index, 
Managed C++ ~. 7 
& Object * value 

); 

private function IListInsert( 

JScriDt indeX : — ' 
^ value : Object 

) : void : 
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Parameters 

index System.Int32. 
value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IList.Remove Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Private Sub IList.Remove( _ 
Visual Basic ByVal value As Object _ 
) 

private void IList.Remove( 
C# object value 

); 

private: void IList.Remove( 
Managed C++ Obj ect* value 

); 

private function IList.Remove( 
JScript value : Obj ect 
) : void ; 

Parameters 

value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IndexOf Method 



Note: This documentation is preliminary and is subject to change. 
Determines the index of a specific grammar in the collection. 
Definition 



Visual Basic Public Function IndexOf( _ 

ByVal grammar As Grammar 
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) As Inte ger 

public int IndexOf( 
C# Grammar grammar 

); 

public: int IndexOf( 
Managed C++ Grammar * grammar 
v 



); 

public function IndexOf( 
JScript grammar : Grammar 
):jnt; 



Parameters 



System.Speech.Recogmtion.Grammar. The grammar to locate in the 
grammar „ r 
6 collection. 

Return Value 

System.Int32. The index of grammar if found in the collection; otherwise, -1. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Insert Method 

Note: This documentation is preliminary and is subject to change. 
Inserts a grammar into the collection at the specified position. 
Definition 

Public Sub Insert( _ 

Visual Basic ByVal index As _ 

ByVal grammar As Grammar _ 

) 

public void Insert( 

int index, 

Grammar grammar 

); 

public: void Insert( 

™ -i . . int index, 
Managed C++ ~ * 

b Grammar * grammar 

); 

public function Insert( 
JScript index : int, 

grammar : Grammar 
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) : void : 

Parameters 

index System.Int32. The zero-based index at which grammar should be inserted. 

System.Speech.Recognition.Grammar. The grammar to insert into the 
grammar J 11 r 
* collection. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Remove Method 

Note: This documentation is preliminary and is subject to change. 
Removes the first occurrence of the specified grammar from the collection. 
Definition 

Public Sub Remove( _ 
Visual Basic ByVal grammar As Grammar _ 

) 

public void Remove( 
C# Grammar grammar 

); 

public: void Remove( 
Managed C++ Grammar * grammar 

); 

public function Remove( 
JScript grammar : Grammar 
) : void ; 

Parameters 

System.Speech.Recognition.Grammar. The grammar to remove from the 
grammar „ . • 
65 collection. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RemoveAt Method 

Note: This documentation is preliminary and is subject to change. 
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Removes the specified item from the collection. 
Definition 

Public Sub RemoveAt( _ 
Visual Basic ByVal index As Integ er _ 
) 

public void RemoveAt( 
C# int index 

); 

public: void RemoveAt( 
Managed C++ int index 

); 

public function RemoveAt( 
JScript index : int 
) : void ; 

Parameters 

index System.Int32. The zero-based index of the item to remove. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Count Property 



Note: This documentation is preliminary and is subject to change. 

Gets the number of items in this collection. 

Definition 

Visual Basic Public ReadOnly Property Count As Integer 
C# public int Count { get; } 

Managed C++ public: property int get_Count(); 

JScript public function get Count() : int 

Property Value 

System.Int32. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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IsFixedSize Property 

Note: This documentation is preliminary and is subject to change. 
Gets a value that specifies whether the collection has a fixed size. 
Definition 

Visual Basic Public ReadOnly Property IsFixedSize As Boolean 
C# public bool IsFixedSize { get; } 

Managed C++ public: property bool get_IsFixedSize(); 

JScript public function get IsFixedSizeO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsReadOnly Property 

Note: This documentation is preliminary and is subject to change. 
Gets a value that specifies whether the collection is read-only. 
Definition 

Visual Basic Public ReadOnly Property IsReadOnly As Boolean 
C# public bool IsReadOnly { get; } 

Managed C++ public: property bool getlsReadOnlyO; 

JScript public function get IsReadOnlyO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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IsSynchronized Property 



Note: This documentation is preliminary and is subject to change. 
Gets a value indicating whether access to the collection is thread-safe. 
Definition 

Visual Basic Public ReadOnly Property IsSynchronized As Boolean 
C# public bool IsSynchronized { get; } 

Managed C++ public: property bool get_IsSynchronized(); 

JScript public function get IsSynchronized() : boolean 

Property Value 

System.Boolean. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 



Note: This documentation is preliminary and is subject to change. 

Gets or sets the Grammar at the specified index. 

Definition 

Public Property Item( _ 
Visual Basic ByVal index As Integer _ 
) As Grammar 

public Grammar this[ 

C# int index 

] { get; set; } 

public: property Grammar * get_Item( 

int index 

); 

Managed C++ public: property void set_Item( 

int index, 
Grammar * 

); 

JScript In JScript, you can use indexed properties, but you cannot define your own. 
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Property Value 

System.Speech.Recognition.Grammar. 

This property is read/write. 
Parameters 

index System.Int32. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SyncRoot Property 



Note: This documentation is preliminary and is subject to change. 
Gets an object that can be used to synchronize access to the collection. 
Definition 

Visual Basic Public ReadOnly Property SyncRoot As Object 
C# public object SyncRoot { get; } 

Managed C++ public: property Object* get_SyncRoot(); 

JScript public function get SyncRootO : Object 

Property Value 

System.Object. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InterferenceEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

Provides data for the Interference event. 

Definition 

1Ti . Public Class InterferenceEventArgs 
Visual Basic T , c 7 r . A 

Inherits SpeechEventArg s 
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C# public class InterferenceEventArgs : S peechEventArg s 

Managed C++ public gc class InterferenceEventArgs : public SpeechEventArgs 

JScript public class InterferenceEventArgs extends S peechEventArgs 

Members Table 
Inheritance Hierarchy 



Object 



[x] Leave 



EventArgs 



xj Leave 



SpeechEventArgs 

InterferenceEventArgs 



Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture==neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InterferenceEventArgs Method 



Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the InterferenceEventArgs class. 
Definition 



Public Sub InterferenceEventArgs( _ 
Visual Basic ByVal audioPosition As TimeSp an- _ 
4 ^ ^ Ab 1 ByVal interference As InterferenceTyp e 

) 

public InterferenceEventArgs( 
£g TimeSp an audioPosition^ 

InterferenceTyp e interference 

); 

public: InterferenceEventArgs( 
Managed C++ TimeSpan audioPosition, 

5 InterferenceType interference 

);■ 
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public function InterferenceEventArgs( 
T ~ . audioPosition : TimeSpan . 

cni> interference : InterferenceType 

); 



Parameters 

audioPosition System.TimeSpan. Placeholder 

interference System.Speech.Recognition.InterferenceType. Interference event type. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Interference Property 

Note: This documentation is preliminary and is subject to change. 

Gets the interference type. 

Definition 

Visual Basic Public ReadOnly Property Interference As InterferenceType 
C# public InterferenceType Interference { get; } 

Managed C++ public: property InterferenceTyp e get_Interference(); 

JScript public function get InterferenceO : InterferenceTyp e 

Property Value 

System.Speech.Recognition.InterferenceType. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

LocalRecognizer Class 

Note: This documentation is preliminary and is subject to change. 

This class allows applications to create a private instance of a Recognizer in their own address space. 
Definition 

Public Class LocalRecognizer 

*w/r -\wr\mnwQ\TPiv/rp\^ViinPPAQ him 7/1/04 
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V" ual Basic ^ e ^ s Object 

Implements IDisposable . IRecognizer 

public class LocalRecognizer : Object , 
IDisposable , IRecognizer 

public gc class LocalRecognizer : public Object , 

Managed C++ iDi sposa ble . IRecognizer 

. f public class LocalRecognizer extends Object 
cn P implements IRecog nizer, IDisposable 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



LocalRecognizer 

Remarks 

Unlike the SystemRecognizer which is shared with other processes on the system, the 
LocalRecognizer is totally under the control of the process that creates it. 

Each instance of the LocalRecognizer class represents a single recognition engine. The 
application can connect to each recognition engine one or more recognition contexts, from 
which the application can control the recognition grammars to be used, start and stop 
recognition, and receive events and recognition results. A standard application may not need 
to call many of the methods on this class as the default settings are likely satisfactory. 

Class Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AdaptLanguageModel Method 

Note: This documentation is preliminary and is subject to change. 

Passes a block of text to the recognition engine which can be used to adapt the active language models. 
Overload List 



ci~.//rM™rr\TT^^wo\Tr?A/ro\_ .^u-dt: a o v»+™ 



1IVOA 



Interacting with the Computer using Speech Input and Speech Output Page 61 of 357 

public Void AdaptLanguageModel (String) 
public Void AdaptLanguageModel (Stringfl ) 

public Void AdaptLanguageModel (String. String, AdaptationSettings, AdaptationRelevance) 

public Void AdaptLanguageModel (String 

[]. String. AdaptationSettings. AdaptationRelevance) 



© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

CancelRecognizeAsync Method 



Note: This documentation is preliminary and is subject to change. 

Cancels the currently executing asynchronous operation. If no asynchronous operation is currently 
executing, nothing happens. 

Definition 

Visual Basic Public Sub CancelRecognizeAsyncO 
C# public void CancelRecognizeAsyncO; 
Managed C++ public: void CancelRecognizeAsyncO; 

JScript public function CancelRecognizeAsyncO : void : 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 



Note: This documentation is preliminary and is subject to change. 

Releases SAPI resources. 

Definition 

Visual Basic Public Sub DisposeO 
C# public void DisposeO; 
Managed C++ public: void DisposeO; 

JScript public function DisposeQ : void ; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

EmulateRecognize Method 
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Note: This documentation is preliminary and is subject to change. 

Simulates a speech recognition event by assuming the specified text was spoken. 

Overload List 

public Void EmulateRecognize (String) 

public Void EmulateRecognize (String, CompareOptions) 

public Void EmulateRecognize (String []) 

public Void EmulateRecognize (Stringfl, CompareOptions) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



InsertBookmark Method 



Note: This documentation is preliminary and is subject to change. 



Sets a bookmark at a particular stream position. 



Definition 



Public Sub InsertBookmark( 



Visual Basic 




By Val tag As Object _ 

) 

public void InsertBookmark( 



C# 



TimeSpan StreamTimeToDoBookmark, 



object tag 

); 

public: void InsertBookmark( 



Managed C++ 



TimeSpan streamTimeToDoBookmark, 



Obj ect* tag 

); . 

public function InsertBookmark( 



JScript 



streamTimeToDoBookmark : TimeSpan , 



tag : Object 
) : void ; 



Parameters 



StreamTimeToDoBookmark System.TimeSpan. 
tag System.Object. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InsertBookmarkAhead Method 

Note: This documentation is preliminary and is subject to change. 
Sets a bookmark at a particular time ahead of the current audio position. 
Definition 

Public Sub InsertBookmarkAhead( _ 

. ByVal timeAheadToDoBookmark As TimeSpan . 
Visual Basic ByVa l ^ As Object _ 

) 

public void InsertBookmarkAhead( 
TimeSpan timeAheadToDoBookmark, 
object tag 

)v 

public: void InsertBookmarkAhead( 
_ _ , TimeSpan timeAheadToDoBookmark, 
Managed C++ Object * taz 

); 

public function InsertBookmarkAhead( 

. timeAheadToDoBookmark : TimeSpan , 

Cnp tag : Object 

) : void ; 

Parameters 

timeAheadToDoBookmark System.TimeSpan. 
tag System.Object 

© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

LocalRecognizer Method 

Note: This documentation is preliminary and is subject to change. 
Creates a new default LocalRecognizer. 
Overload List 

public LocalRecognizer 0 
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public LocalRecognizer fRecognizerAttributes) 
public LocalRecognizer (Culturelnfo Class) 
public LocalRecognizer (Strin g) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognize Method 

Note: This documentation is preliminary and is subject to change. 

Begins synchronous recognition, which terminates when a phrase has been recognized or after timeout. 
Overload List 

public RecognitionResult Recognize Q 

public RecognitionResult Recognize fRecognizeMode) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeAsync Method 

Note: This documentation is preliminary and is subject to change. 

Begins asynchronous recognition. Calling RecognizeAsync() while a previous RecognizeAsyncO is still 
executing will block until the previous operation completes. 

Overload List 

public Void RecognizeAsync Q 

public Void RecognizeAsync (RecognizeMode) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RequestUpdate Method 

Note: This documentation is preliminary and is subject to change. 

Requests an update as soon as the engine can accept it. The system will fire the Update event once the 
recognizer is ready to receive updates. 



f;u-//r.\^nr\Tnnw«\TFA/rp\^ViV»ppAQ htm 



2/3/04 



Interacting with the Computer using Speech Input and Speech Output 



Page 65 of 357 



Overload List 



public Void RequestUpdate Q 

public Void RequestUpdate (Object) 

public Void RequestUpdate (TimeSpan, Object) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RequestUpdateAhead Method 



Note: This documentation is preliminary and is subject to change. 

Requests an update as soon as the engine can accept it. The system will fire the Update event once the 
recognizer is ready to receive updates. 

Definition 

Public Sub RequestUpdateAhead( _ 
. . ByVal timeAheadToDoUpdate As TimeSpan . _ 

Visual Basic B yVal tag As Object _ 

) 

public void RequestUpdateAhead( 
£g TimeSpan timeAheadToDoUpdate, 

object tag 

); 

public: void RequestUpdateAhead( 
lv/T a n i TimeSp an timeAheadToDoUpdate, 
Managed C++ object* tog 

); 

public function RequestUpdateAhead( 

. f timeAheadToDoUpdate : TimeSp an, 
p tag : Object 

) : void ; 

Parameters 

timeAheadToDoUpdate System.TimeSpan. 
tag System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

StopRecognizeAsync Method 
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Note: This documentation is preliminary and is subject to change. 

Stops the asynchronous recognition operation for Single and Multiple recognition modes. 

Definition 

Visual Basic Public Sub StopRecognizeAsyncO 

C# public void StopRecognizeAsyncO; 
Managed C++ public: void StopRecognizeAsyncO; 

JScript public function StopRecognizeAsyncO : void : 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

WaitForUpdate Method 



Note: This documentation is preliminary and is subject to change. 

Waits until the engine is ready to perform an update. The system will fire the Update event once the 
recognizer is ready to receive updates. This call will block until after this event is processed. 

Definition 

Visual Basic Public Sub WaitForUpdateO 
C# public void WaitForUpdateO; 
Managed C++ public: void WaitForUpdateO; 

JScript public function WaitForUpdateO : void; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Attributes Property 



Note: This documentation is preliminary and is subject to change. 

Gets the attributes of the recognizer. 

Definition 

Visual Basic Public ReadOnly Property Attributes As RecognizerAttributes 
C# public RecognizerAttributes Attributes { get; } 

Managed C++ public: property RecognizerAttributes * get_Attributes(); 

JScript public function get Attributes() : RecognizerAttributes 



J/VCid 
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Property Value 

System.Speech.Recognition.RecognizerAttributes. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContent Property 

Note: This documentation is preliminary and is subject to change. 

Gets the audio input received by the recognizer. 

Definition 

Visual Basic Public ReadOnly Property AudioContent As AudioContent 
C# public AudioContent AudioContent { get; } 

Managed C++ public: property AudioContent get_AudioContent(); 

JScript public function get AudioContentO : AudioContent 

Property Value 

System.Speech.Recognition.AudioContent. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AvailableRecognizers Property 

Note: This documentation is preliminary and is subject to change. 
Gets the attributes of all the recognizers that are installed on the system 
Definition 

Visual Basic Public Shared ReadOnly Property AvailableRecognizers As Recognizers 
C# public static Recognizers AvailableRecognizers { get; } 

Managed C++ public: property static Recognizers * get_AvailableRecognizers(); 

JScript public static function get AvailableRecognizersQ : Recognizers 
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Property Value 

System.Speech.Recognition.Recognizers. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BabbleTimeout Property 

Note: This documentation is preliminary and is subject to change. 
Specifies the maximum time that is allowed for an utterance or recording. 
Definition 

Visual Basic Public Property BabbleTimeout As TimeSpan 

C# public TimeSpan BabbleTimeout { get; set; } 

- r public: property TimeSpan getBabbleTimeoutO; 

Managed C++ public . _p roperty void se t BabbleTimeout(TimeSpan); 

. public function get BabbleTimeoutO : TimeSp an 
cn P public function set BabbleTimeout( TimeSpan ): 

Property Value 

System.TimeSpan. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

EnableRejection Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets a value that specifies whether the Recognizer splits Recognitions into those that it is 
confident are correct (Recognition events), and those it is not (RejectedRecognition events). Otherwise 
all recognitions raise Recognition events. By default this is set to true. 

Definition 

Visual Basic Public Property EnableRejection As Boolean 
C# public bool EnableRejection { get; set; } 
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r public: property bool get_Enab!eRejection(); 

anage public: property void setEnableRejection(booI); 

• f public function get EnableRejectionO : boolean 

cnp public function set EnableRejection(boolean); 



Property Value 



System.BooIean. 



This property is read/write. 



© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

Grammars Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of available grammars. 

Definition 

Visual Basic Public ReadOnly Property Grammars As GrammarCoIlection 
C# public GrammarCoIlection Grammars { get; } 

Managed C++ public: property GrammarCoIlection * get GrammarsQ; 

JScript public function get Grammars() : GrammarCoIlection 

Property Value 

System.Speech.Recognition.GrammarCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InitialSilenceTimeout Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets the time the recognizer allows between when the microphone is turned on, and recognition 
starts. 

Definition 
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Visual Basic Public Property InitialSilenceTimeout As TimeSpan 

C# public TimeSp an InitialSilenceTimeout { get; set; } 

public: property TimeSpan get_InitialSilenceTimeout(); 

Managed C++ public: _p rop erty void setJnitialSilenceTimeout( TimeSp an); 

. public function get InitialSilenceTimeoutO : TimeSpan 
P public function set InitialSilenceTimeoutf TimeSpan ); 

Property Value 

System.TimeSpan. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsActive Property 

Note: This documentation is preliminary and is subject to change. 

Gets or sets a value that specifies whether to activate and deactivate a set of grammars simultaneously 
when using a shared recognizer. 

Definition 

Visual Basic Public Property IsActive As Boolean 
C# public boot IsActive { get; set; } 

M^naapH r++ P ublic: _J r0 P ert y *™Ql get_IsActive(); 
ivianagea w pubUc . _p roperty void S et_IsActive(bool); 

• f public function get IsActiveO * boolean 
cn P public function set IsActive( boolean ); 

Property Value 

System.Boolean. 

This property is read/write. 
Remarks 

For a top-level rule to be recognized, it must be active, it must be housed in an active 
grammar, and that grammar must be housed in a recognizer that is active. If any one of 
these three conditions are not met, the rule cannot be recognized. Setting this method is 
used in the shared case to activate and deactivate a set of grammars simultaneously. 
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© 2003 Microsoft Corporation. Ail rights reserved. Terms of use. 

Properties Property 

Note: This documentation is preliminary and is subject to change. 

Gets the properties of the recognizer. 

Definition 

Visual Basic Public Readonly Property Properties As RecognizerProperties 
C# public RecognizerProperties Properties { get; } 

Managed C++ public: property Recogn izerPr operties * getJPropertiesQ; 

JScript public function get PropertiesO • RecognizerProperties 

Property Value 

System.Speech.Recognition.RecognizerProperties. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

State Property 

Note: This documentation is preliminary and is subject to change. 

Gets the current state of the recognizer. 

Definition 

Visual Basic Public ReadOnly Property State As RecognizerState 
C# public RecognizerState State { get; } 

Managed C++ public: property RecognizerState get_State(); 

JScript public function get StateO : RecognizerState 

Property Value 

System.Speech.Recognition.RecognizerState. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContentChanged Event 



Note: This documentation is preliminary and is subject to change. 
Occurs when the type of signal in the audio input changed. 
Definition 

Visual Basic Eyent Auc iioContentChanged As AudioContentChangedEventHandler 



C# public event AudioContentChangedEventHandler AudioContentChanged; 

Managed p U ^ c: even t AudioContentChanged; 

C++ 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Bookmark Event 



Note: This documentation is preliminary and is subject to change. 

Occurs when a bookmark is reached. 

Definition 

Visual Basic Public Event Bookmark As BookmarkEventHandler 
C# public event BoolvnarkEventHandler Bookmark; 

Managed C++ public: event Bookmark; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Hypothesis Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is partially recognized. 
Definition 
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Visual Basic Public Event Hypothesis As RecognitionEventHandler 

C# public event RecognitionEventHandler Hypothesis; 
Managed C++ public: event Hypothesis; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

InterferenceDetected Event 



Note: This documentation is preliminary and is subject to change. 

Occurs when the speech recognition engine encounters interference in the input audio stream. 
Definition 

Visual Basic Public Event InterferenceDetected As InterferenceEventHandler 
C# public event InterferenceEventHandler InterferenceDetected; 

Managed C++ public: event InterferenceDetected; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

NoRecognition Event 



Note: This documentation is preliminary and is subject to change. 

Occurs when a spoken phrase is not recognized. 

Definition 

Visual Basic Public Event NoRecognition As RecognitionEventHandler 
C# public event RecognitionEventHandler NoRecognition ; 

Managed C++ public: event NoRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognition Event 
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Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is successfully recognized. 
Definition 

Visual Basic Public Event Recognition As RecognitionEventHandler 
C# public event RecognitionEventHandler Recognition; 

Managed C++ public: event Recognition; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeCompleted Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when recognition is complete. 

Definition 

Public Event RecognizeCompleted As RecognizeCompletedEventHandler 
public event RecognizeCompletedEventHandler RecognizeCompleted; 

public: event RecognizeCompleted; 

In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeProgressChanged Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when recognition progress is made. 

Definition 

Visual Public 

Basic Event RecognizeProgressChanged As RecognizeProgressChangedEventHandler 

£0 public event 

RecognizeProgressChangedEventHandler RecognizeProgressChanged; 

Managed 

^io.//r.\wrNrnnwQ\TPA/rp\^,v>v,T7-p aq v.tm ont(\A 



Visual Basic 
C# 

Managed 

C++ 

JScript 
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C++ public: event RecognizeProgressChanged; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerStateChanged Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when recognition starts, or stops; or when recognition is canceled, paused, or resumed. 
Definition 

Visual Public 

Basic Event RecognizerStateChanged As RecogfiizerStateChangedEventHandler 

u public event 

RecognizerStateChangedEventHandler RecognizerStateChanged; 

Managed public: _ event RecognizerStateChanged; 
C++ 

JScript In JScript, you can use events, but you cannot define your own. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RejectedRecognition Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is recognized with low confidence. 
Definition 

Visual Basic Public Event RejectedRecognition As RecognitionEventHandler 
C# public event RecognitionEventHandler RejectedRecognition; 

Managed C++ public: event RejectedRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

Update Event 
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Note: This documentation is preliminary and is subject to change. 

Occurs when the Update button is clicked. 

Definition 

Visual Basic Public Event Update As UpdateEventHandler 
C# public event UpdateEventHandler Update; 

Managed C++ public: event Update; 

JScript hi JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionAudio Class 

Note: This documentation is preliminary and is subject to change. 

Contains the audio data and methods for a specific RecognitionResult or a portion of a 
RecognitionResult. 

Definition 

_ 7 . . _ . Public Class RecognitionAudio 
Visual Basic T , ~, . , to 

Inherits Object 

C# public class RecognitionAudio : Object 

Managed C++ public gc class RecognitionAudio : public Object 

JScript public class RecognitionAudio extends Object 

Members Table 
Inheritance Hierarchy 



Object 



[x] Leave 



RecognitionAudio 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetAudio Method 

Note: This documentation is preliminary and is subject to change. 
Gets all the audio associated with this instance of RecognitionAudio. 
Overload List 

public Void GetAudio (Stream) 

public Void GetAudio (Stream. TimeSpan, TimeSpan) 

public Void GetAudio (Stream. Int32» Int32) 

© 2003 Microsoft C or poration. All rights reserved. Terms of use. 

AudioLength Property 

Note: This documentation is preliminary and is subject to change. 

Gets the length of the audio data. 

Definition 

Visual Basic Public ReadOnly Property AudioLength As TimeSp an 
C# public TimeSpan AudioLength { get; } 

Managed C++ public: property TimeSpan getAudioLengthO; 

JScript public function get AudioLength() : TimeSp an 

Property Value . 

System.TimeSpan . 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioPosition Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the start point of the audio data, relative to the start of the stream. 
Definition 



Visual Basic Public ReadOnly Property AudioPosition As TimeSpan 
C# public TimeSpan AudioPosition { get; } 

Managed C++ public: property TimeSp an get_AudioPosition(); 

JScript public function get AudioPositionQ : TimeSpan 

Property Value 

System.TimeSpan. 

This property is read-only. 



© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

RecognitionEventArgs Class 



Note: This documentation is preliminary and is subject to change. 

Provides data for the Recognition, RejectedRecognition, and Hypothesis events. 

Definition 

\/* id • Public Class RecognitionEventArgs 
visual Jtsasic T i • , o 7 t-» , j 

Inhents SpeechEventArg s 

C# public class RecognitionEventArgs : SpeechEventA rgs 

Managed C++ public gc class RecognitionEventArgs : public SpeechEventArgs 

JScript public class RecognitionEventArgs extends SpeechEventA rgs 

Members Table 
Inheritance Hierarchy 





2 Leave 


Object 





EventArgs 



3 Leave 



SpeechEventArgs 

RecognitionEventArgs 



Class Information 
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Namespace System. Speech.Recognition 

Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the RecognitionEventArgs class. 
Definition 

Public Sub RecognitionEventArgs( 
ByVal audioPosition As TimeSp an, _ 
Visual Basic ByVal result As RecognitionResult _ 
ByVal resultType As ResultType _ 

) 

public RecognitionEventArgs( 
TimeSp an audioPosition, 
C# Reco gnitionResult result, 

ResultType resultType 

); 

public: RecognitionEventArgs( 
TimeSp an audioPosition, 
Managed C++ RecognitionResult * result, 
ResultType resultType 

); 

public function RecognitionEventArgs( 
audioPosition : TimeSpan . 
JScript result : RecognitionResult . 

resultType : ResultType 

); 

Parameters 



audioPosition System.TimeSpan. Placeholder 

result System.Speech.Recognition.RecognitionResult. Result representing the 

recognized phrase. 

resultType System.Speech.Recognition.ResultType. Type of result 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Result Property 

Note: This documentation is preliminary and is subject to change. 

Gets the result of a recognition. 

Definition 

Visual Basic Public ReadOnly Property Result As RecognitionResult 

C# public RecognitionResult Result { get; } 
Managed C++ public: _property RecognitionResult * get_Result(); 
JScript public function get ResultQ : RecognitionResult 

Property Value 

System.Speech.Recognition.RecognitionResult 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ResultType Property 

Note: This documentation is preliminary and is subject to change. 

Gets the type of recognition result. 

Definition 

Visual Basic Public ReadOnly Property ResultType As ResultType 
C# public ResultType ResultType { get; } 

Managed C++ public: property ResultType get_ResultType(); 

JScript public function get ResultType() : ResultTyp e 

Property Value 

System.Speech.Recognition.ResultType. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use 
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RecognitionPhrase Class 



Note: This documentation is preliminary and is subject to change. 
Represents the phrase that was recognized by the recognizer. 
Definition 

Public Class RecognitionPhrase 
Visual Basic Inherits Object 

Implements IDisposable 

public class RecognitionPhrase : Object , 
IDisposable 

Mana ed C++ P u ^ c § c c ^ ass RecognitionPhrase : public Object . 

* IDisposable 

• t public class RecognitionPhrase extends Object 
p implements IDisposable 

Members Table 
Inheritance Hierarchy 



Object 



[x] Leave 



RecognitionPhrase 

Reco gnitionPhr ase Alternate 
RecognitionResult 



Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 



Note: This documentation is preliminary and is subject to change. 
Releases SAPI resources. 
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Overload List 

public Void Dispose Q 
public Void Dispose (Boolean) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Finalize Method 

Note: This documentation is preliminary and is subject to change. 

Destructor. 

Definition 

Visual Basic Overrides Protected Sub FinalizeO 

C# -RecognitionPhraseO; 
Managed C++ -RecognitionPhraseO; 

JScript protected override function FinalizeO : void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Audio Property 

Note: This documentation is preliminary and is subject to change. 

Gets the audio for this phrase. 

Definition 

Visual Basic Public ReadOnly Property Audio As Recognition Au dio 
C# public RecognitionAudio Audio { get; } 

Managed C++ public: property RecognitionAudio * get_Audio(); 

JScript public function get Audio() :" RecognitionAudio 

Property Value 

System.Speech.Recognition.RecognitionAudio. 

This property is read-only. 
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Note: This documentation is preliminary and is subject to change. 
Gets the confidence score information included in recognition results. 
Definition 

Visual Basic Public ReadOnly Property Confidence As Confidence 
C# public Confidence Confidence { get; } 

Managed C++ public: property Confidence get_Confidence(); 

JScript public function get Confidence() : Confidence 

Property Value 

System.Speech.Recognition.Confidence. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

EnginePrivateData Property 

Note: This documentation is preliminary and is subject to change. 

Gets an array of additional engine-specific data returned by the recognition engine. 

Definition 

Visual Basic Public ReadOnly Property EnginePrivateData As ByteQ 
C# public byte [] EnginePrivateData { get; } 

Managed C++ public: property Byte get_EnginePrivateData(); 

JScript public function get EnginePrivateDataO : byte [] 

Property Value 

System.Byte. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Grammar Property 

Note: This documentation is preliminary and is subject to change. 
Gets the grammar that contained the rule that produced this result. 
Definition 

Visual Basic Public ReadOnly Property Grammar As Grammar 
C# public Grammar Grammar { get; } 

Managed C++ public: property Grammar * get_Grammar(); 

JScript public function get GrammarO : Grammar 

Property Value 

System.Speech.Recognition.Grammar. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Language Property 

Note: This documentation is preliminary and is subject to change. 

Gets the language ID for the current Culturelnfo. 

Definition 

Visual Basic Public ReadOnly Property Language As Culturelnfo Class 
C# public Culturelnfo Class Language { get; } 

Managed C++ public: property Culturelnfo Class * get_Language(); 

JScript public function get LanguageO Culturelnfo Class 

Property Value 

System.GIobalization.Culturelnfo. 

This property is read-only. 
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Properties Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of semantic properties associated with this RecognitionPhrase. 

Definition 

Visual Basic Public ReadOnly Property Properties As SemanticPropertyCoIlection 
C# public SemanticPropertyCoIlection Properties { get; } 

Managed C++ public: property SemanticPropertyCoIlection * getJProperties(); 

JScript public function get PropertiesO : SemanticPropertyCoIlection 

Property Value 

System.Speech.Recognition.SemanticPropertyCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

RecognizerConfidence Property 

Note: This documentation is preliminary and is subject to change. 
Gets the confidence score information included in recognition results. 
Definition 

Visual Basic Public ReadOnly Property RecognizerConfidence As Sing le 
C# public float RecognizerConfidence { get; } 

Managed C++ public: property float get RecognizerConfidenceQ; 

JScript public function get RecognizerConfidenceO : float 

Property Value 

System.Single. 

This property is read-only. 
Remarks 
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This value is not standardized across multiple speech recognizers, and may change from 
version to version of a specific recognizer. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Rule Property 

Note: This documentation is preliminary and is subject to change. 

Gets the rule that allowed this result to be recognized, and the rule's parse tree. 

Definition 

Visual Basic Public ReadOnly Property Rule As RecognitionRule 
C# public RecognitionRule Rule { get; } 

Managed C++ public: property RecognitionRule * get_Rule(); 

JScript public function get Rule() : Reco gnitionRule 

Property Value 

System.Speech.Recognition.RecognitionRule. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SmI Property 

Note: This documentation is preliminary and is subject to change. 
Returns the XML that represents the semantic properties, in SML form. 
Definition 

Visual Basic Public ReadOnly Property Sml As String 
C# public string Sml { get; } 

Managed C++ public: property String * get_Sml(); 

JScript public function get Sml() : String 

Property Value 

System.String. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpokenText Property 

Note: This documentation is preliminary and is subject to change. 

Gets the spoken text for this phrase. 

Definition 

Visual Basic Public ReadOnly Property SpokenText As String 
C# public string SpokenText { get; } 

Managed C++ public: property String * get_SpokenText(); 

JScript public function get SpokenTextO : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpokenTokens Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of tokens that make up this RecognitionPhrase. 
Definition 

Visual Basic Public ReadOnly Property SpokenTokens As SpokenTokenCollection 
C# public S pokenTokenCollection SpokenTokens { get; } 

Managed C++ public. property S pokenTokenCollection * getSpokenTokensO; 

JScript public function get SpokenTokens() : SpokenTokenCollection 

Property Value 

System.Speech.Recognition.SpokenTokenCollection. 
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This property is read-only. 
Remarks 

There are two forms of the recognition result, available as the SpokenTokens property and 
the Tokens property. The SpokenTokens property represents the lexical words that were 
recognized, and allows access to attributes like lexical text, pronunciation, and confidence 
score. The Tokens property represents the text of the recognized words and allows access to 
the display text and leading and trailing space information. 

For example, the speech "there are thirteen donuts in a baker's dozen period" will result in 
"there are thirteen donuts in a baker's dozen period" for the SpokenTokens property, and 
"There are 13 donuts in a baker's dozen." for the Tokens property. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 



Note: This documentation is preliminary and is subject to change. 

Gets the written text for this phrase. 

Definition 

Visual Basic Public ReadOnly Property Text As String 
C# public string Text { get; } 

Managed C++ public: property String * get_Text(); 

JScript public function get Text() : String 

Property Value 

System.String. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Tokens Property 



Note: This documentation is preliminary and is subject to change. 
Gets the collection of tokens that make up this RecognitionPhrase. 
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Definition 



Visual Basic Public ReadOnly Property Tokens As Dis playTokenCollection 

C# public DisplayTokenCollection Tokens { get; } 
Managed C++ public: property DisplayTokenCollection * get_Tokens(); 
JScript public function get TokensQ : DisplayTokenCollection 



Property Value 

System.Speech.Recognition.DisplayTokenCollection. 

This property is read-only. 
Remarks 



There are two forms of the recognition result, available as the SpokenTokens property and 
the Tokens property. The SpokenTokens property represents the lexical words that were 
recognized, and allows access to attributes like lexical text, pronunciation, and confidence 
score. The Tokens property represents the text of the recognized words and allows access to 
the display text and leading and trailing space information. 

For example, the speech "there are thirteen donuts in a baker's dozen period" will result in 
"there are thirteen donuts in a baker's dozen period" for the SpokenTokens property, and 
"There are 13 donuts in a baker's dozen." for the Tokens property. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionPhraseAlternate Class 



Note: This documentation is preliminary and is subject to change. 

Contains information about an alternate recognition by the speech recognizer. 

Definition 



Visual Basic Public Class RecognitionPhraseAlternate 

Inherits RecognitionPhrase 



C# 

Managed 

C++ 

JScript 



public class RecognitionPhraseAlternate : RecognitionPhrase 
public gc 

class RecognitionPhraseAlternate : public RecognitionPhrase 
public class RecognitionPhraseAlternate extends RecognitionPhrase 



Members Table. 



Inheritance Hierarchy 
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fx] Leave 
Object ! U 



RecognitionPhrase 

RecognitionPhraseAlternate 



Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 

Note: This documentation is preliminary and is subject to change. 
Definition 



Overrides Protected Sub Dispose( _ 
Visual Basic ByVal disposing As Boolean _ 

) 

protected override void Dispose( 
C# bool disposing 

); 

protected: void Dispose( 
Managed C++ bool disposing 

); 

protected override function Dispose( 
JScript disposing : boolean 
) : void : 



Parameters 

disposing System.BooIean. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AlternateSpokenText Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the text of an alternate recognition result representing an actual spoken word unit, including lexical 
text, pronunciation, and confidence score. 

Definition 



Visual Basic Public Readonly Property AlternateSpokenText As String 

C# public string AlternateSpokenText { get; } 
Managed C++ public: __property String * get_AiternateSpokenText(); 
JScript public function get AlternateSpokenText() : String 

Property Value 

System.String. 

This property is read-only. 
Remarks 

This alternative text does not include the text that was the same as in the original result, 
either at the beginning, or at the end. The Text property contains full text for this 
alternative, including the text that was the same as in the original result, at the beginning 
and at the end 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AlternateSpokenTokens Property 



Note: This documentation is preliminary and is subject to change. 

Gets the collection of tokens representing actual spoken word units not present at the beginning or the 
end of the original result. 

Definition 

\^isual 

Basic Pu k lic Read0nl y Property AlternateSpokenTokens As SpokenTokenCollection 
C# public S pokenTokenCollection AlternateSpokenTokens { get; } 
Managed public . __p roperty SpokenTokenCollection * get_AlternateSpokenTokens(); 
JScript public function get AlternateSpokenTokensO : SpokenTokenCollection 
Property Value 

System.Speech.Recognition.SpokenTokenCollection. 



ffie://C:\WINDOWS\TEMP\~hhEEA9.htm 



2/3/04 



Interacting with the Computer using Speech Input and Speech Output 



Page 92 of 357 



This property is read-only. 
Remarks 

This alternative collection of tokens does not include the tokens that were the same as in the 
original result, either at the beginning, or at the end. The Tokens property contains full . 
collection of tokens for this alternative, including the tokens that were the same as in the 
original collection of tokens, at the beginning and at the end 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AlternateText Property 



Note: This documentation is preliminary and is subject to change. 

Gets the normalized form of an alternate recognition result, including display text and normalized text, 
and white-space information. 

Definition 

Visual Basic Public ReadOnly Property AlternateText As String 
C# public string AlternateText { get; } 

Managed C++ public: property String * get_AlternateText(); 

JScript public function get Altera ateText() : String 

Property Value 

System.String. 

This property is read-only. 
Remarks 

This alternative text does not include the text that was the same as in the original result, 
either at the beginning, or at the end. The Text property contains full text for this 
alternative, including the text that was the same as in the original result, at the beginning 
and at the end 



© 2003 Microsoft Corporation. All rights reserved, terms of use. 

AlternateTokens Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the collection of tokens representing the alternate normalized form of an alternate recognition 
result, not present at the beginning or the end of the original result. 

Definition 

Visual Basic Public Readonly Property AlternateTokens As DisplayTokenCollection 
C# public DisplayTokenCollection AlternateTokens { get; } 

Managed C++ public: property DisplayTokenCollection * get AlternateTokensQ; 

JScript public function get AlternateTokensO : DisplayTokenCollection 

Property Value 

System.Speech.Recognition.DisplayTokenCollection. 

This property is read-only. 
Remarks 

This alternative collection of tokens does not include the tokens that were the same as in the 
original result, either at the beginning, or at the end. The Tokens property contains full 
collection of tokens for this alternative, including the tokens that were the same as in the 
original collection of tokens, at the beginning and at the end 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OriginalSpokenText Property 



Note: This documentation is preliminary and is subject to change. 

Gets the text representing an actual spoken word unit, including lexical text, pronunciation, and 
confidence score, in the original recognition result that is replaced by the alternate. 

Definition 

Visual Basic Public ReadOnly Property OriginalSpokenText As String 
C# public string OriginalSpokenText { get; } 

Managed C++ public: property String * getOriginalSpokenTextO; 

JScript public function get OriginalSpokenTextO : String 

Property Value 

System.String. 

This property is read-only. 
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Remarks 



This original text does not include the text that was the same as in the alternative, either at 
the beginning, or at the end. The Text property on the result object contains full text for the 
original phrase, including the text that was the same as in the alternative, at the beginning 
and at the end 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OriginalSpokenTokens Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of tokens representing actual spoken words that this alternate replaces. 
Definition 

Bade 1 Public Read0nl Y Property OriginalSpokenTokens As SpokenTokenCollection 
C# public S pokenTokenCollection OriginalSpokenTokens { get; } 

M ^8 ed public: property SpokenTokenCollection * get OriginalSpokenTokensO; 

JScript public function get OriginalSpokenTokensO : S pokenTokenCollection 

Property Value 

System.Speech.Recognition.SpokenTokenCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OriginalText Property 

Note: This documentation is preliminary and is subject to change. j 
Gets the normalized form of the text that this alternative replaces in the original result. 
Definition 

Visual Basic Public ReadOnly Property OriginalText As String 

C# public string OriginalText { get; } 
Managed C++ public: property String * get_OriginalText(); 
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JScript public function get Origin aIText() : String 

Property Value 

System.String. 

This property is read-only. 
Remarks 

This original text does not include the text that was the same as in the alternative, either at 
the beginning, or at the end. The Text property on the result object contains full text for the 
original phrase, including the text that was the same as in the alternative, at the beginning 
and at the end 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OriginalTokens Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of tokens representing the normalized form of the recognition that this alternate 
replaces. 

Definition 

Visual Basic Public ReadOnly Property OriginalTokens As Dis playTokenCollection 
C# public DisplayTokenCollection OriginalTokens { get; } 

Managed C++ public: property DisplayTokenCollection * get OriginalTokensO; 

JScript public function get Origin alTokensQ ■ : Dis playTokenCollection 

Property Value 

System.Speech.Recognition.DisplayTokenCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionPhraseAlternateCollection Class 



Note: This documentation is preliminary and is subject to change. 
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A collection of alternatives for a specific result. 
Definition 

Visual Public Class RecognitionPhraseAlternateCollection 
Basic Inherits ReadOnlyCollectionBase 
C# public class RecognitionPhraseAlternateCollection : ReadOnlyCollectionBase 

Managed public gc 

C++ class RecognitionPhraseAlternateCollection : public ReadOnlyCollectionBase 

JScript public class RecognitionPhraseAlternateCollection extends ReadOnlyCollectionBase 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



^xj Leave 



ReadOnly CollectionB ase 

RecognitionPhraseAlternateCollection 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 

Note: This documentation is preliminary and is subject to change. 

Gets a specific alternative from the collection. 

Definition 

Public ReadOnly Property Item( _ 
Visual Basic ByVal index As Integer _ 

) As RecognitionPhraseAlternate 

public RecognitionPhraseAiternate this[ 

C# int index 

] { get; } 

public: property RecognitionPhraseAlternate * get_Item( 
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_ . r , . int index 

Managed C++ y 

JScript In JScript, you can use indexed properties, but you cannot define your own. 

Property Value 

System.Speech.Recognition.RecognitionPhraseAlternate. 

This property is read-only. 
Parameters 

index System.Int32. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionResult Class 

Note: This documentation is preliminary and is subject to change. 

Represents the result when a speech recognizer processes audio and attempts to recognize user speech. 
Definition 

Visual Basic ^ u ^^ c ^ ass RecognitionResult 

Inherits RecognitionPhrase 

C# public class RecognitionResult : RecognitionPhrase 

Managed C++ public gc class RecognitionResult : public RecognitionPhrase 

JScript public class RecognitionResult extends RecognitionPhrase 

Members Table 
Inheritance Hierarchy 



Object! 



3 Leave 



Reco gnitionPhrase 

RecognitionResult 



Class Information 



Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
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© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

Dispose Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub Dispose( _ 
Visual Basic ByVal disposing As Boolean _ 

) 

protected override void Dispose( 
C# bool disposing 

); 

protected: void Dispose( 
Managed C++ bool disposing 

); 

protected override function Dispose( 
JScript disposing : boolean 
) : void ; 

Parameters 

disposing System.Boolean. 



© 2003 Microsoft Corporation. All rights reserved . Terms of use. 

GetSmlAlternates Method 



Note: This documentation is preliminary and is subject to change. 
Gets the XML that represents the semantic properties in SML form. 
Definition 

Public Function GetSmlAlternates( _ 
Visual Basic ByVal number Of Alternates As Integer _ 
) As Strin g 

C# public string GetSmlAlternates( 

int numberOf Alternates 
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); 

public: String * GetSmIAlternates( 
Managed C++ int numberOfAlternates 

); 

public function GetSmlAlternates( 
JScript numberOfAlternates : int 
) : String ; 

Parameters 

numberOfAlternates System.Int32. 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

PerformCorrection Method 

Note: This documentation is preliminary and is subject to change. 

Specifies that the alternate recognition should replace the recognition selected by the speech recognition 
(SR) engine, thus indicating to the speech recognizer that it can learn from this overriding choice by the 
end user. 

Overload List 

public RecognitionResult PerformCorrection ffiecognitionPhraseAlternate) 
public Void PerformCorrection (Int32, Int32. String) 

Remarks 

Not all speech recognizers learn from this information. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Alternates Property 

Note: This documentation is preliminary and is subject to change. 
Gets a collection of alternate phrases. 
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Definition 

VlSU al 

„ . Public ReadOnly Property Alternates As RecognitionPhraseAlternateCollection 
isasic 

C# public RecognitionPhraseAlternateCoIlection Alternates { get; } 
M (^++ ed public: property RecognitionPhraseAIternateCollection * get_Alternates(); 
JScript public function get AlternatesO : RecognitionPhraseAlternateCollection 

. Property Value 

System.Speech.Recognition.RecognitionPhraseAlternateCollection. 

This property is read-only. 
Remarks 

Alternates differs from GetAlternates in that the developer does not specify the focus of 
where to look for alternates in the collection of tokens. The Alternates collection returned 
by the Alternates property is the same as what would be returned from GetAlternates when 
specifying the first token, and the number of tokens in the Tokens collection. 

Many recognitions, successful or not, frequently return several words or phrases that closely 
match the spoken sequence. The one most nearly matching the sequence with a high 
confidence level is returned as a successful recognition. The other words and phrases are 
returned as alternates that are available for examination. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioLength Property 

Note: This documentation is preliminary and is subject to change. 

Gets the length of the audio this result contains. 

Definition 

Visual Basic Public ReadOnly Property AudioLength As TimeSpan 
C# public TimeSp an AudioLength { get; } 

Managed C++ public: property TimeSpan get_AudioLength(); 

JScript public function get AudioLengthO : TimeSp an 

Property Value 

System.TimeSpan . 
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This property is read-only. 
Remarks 

This is the latest point that any of the times in the main result or alternates will refer to. This 
is equivalent to ullLength in RecoResultTimes. 

© 2003 Microsoft Corporation. Ail rights reserved. Terms of use. 

AudioPosition Property 

Note: This documentation is preliminary and is subject to change. 

Gets the time between the start of the stream and the start of the result audio. 

Definition 

Visual Basic Public ReadOnly Property AudioPosition As TimeSpan 
C# public TimeSpan AudioPosition { get; } 

Managed C++ public: property TimeSp an get_AudioPosition(); 

JScript public function get AudioPositionO : TimeSp an 

Property Value 

System.TimeSpan. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsEmulatedResult Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the result is a text-based emulation of a recognition result, for 
example from calling the EmulateRecognize method. 

Definition 

Visual Basic Public ReadOnly Property IsEmulatedResult As Boolean 

C# public bool IsEmulatedResult { get; } 
Managed C++ public: property bool get_IsEmulatedResult(); 
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JScript public function get IsEmuIatedResult() : boo lean 
Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

StartTime Property 

Note: This documentation is preliminary and is subject to change. 

Gets the instant in time, expressed as a date and time of day, that the user started speaking. 
Definition 

Visual Basic Public ReadOnly Property StartTime As Date 
C# public DateTime StartTime { get; } 

Managed C++ public: property DateTime get_StartTime(); 

JScript public function get StartTimeO : DateTime 

Property Value 

System.DateTime. 

This property is read-only. 
Remarks 

For recognition from non-real time audio sources, currently StartTime should throw but 
could think about changing SAPI here. This is ftStreamTime from RecoResultTimes. It is 
possible to use this to measure the latency between the user finishing speaking and the 
recognition result being returned: TimeSpan latency = DateTime.Now - (result.StartTime + 
result.AudioLength) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionRule Class 

Note: This documentation is preliminary and is subject to change. 
tti*.//r •\\ArrMnnw«\TP , A/rp\^fiT7P a q htm 



2/V04 



Interacting with the Computer using Speech input and Speech Output 



Page 103 of 357 



Represents the rule that allowed the associated result to be recognized. 
Definition 

. Public Class RecognitionRule 
Visual oasic T ■• s-%r . , 
Inherits Object 

C# public class RecognitionRule : Object 

Managed C++ public gc class RecognitionRule : public Object 

JScript public class RecognitionRule extends Object 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



RecognitionRule 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Confidence Property 



Note: This documentation is preliminary and is subject to change. 

Gets confidence score information that expresses how confident the speech Recognizer is that this is the 
correct rule. 

Definition 

Visual Basic Public ReadOnly Property Confidence As Confidence 
C# public Confidence Confidence { get; } 

Managed C++ public: property Confidence get ConfidenceO; 

JScript public function get ConfidenceO : Confidence 

Property Value 

System.Speech.Recognition.Confidence. 
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This property is read-only. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets the name of the rule that was recognized. 

Definition 

Visual Basic Public ReadOnly Property Name As String 
C# public string Name { get; } 

Managed C++ public: property String * get_Name(); 

JScript public function get Name() : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerConfidence Property 

Note: This documentation is preliminary and is subject to change. 

Gets confidence score information that expresses how confident the speech Recognizer is that this is the 
correct rule. 

Definition 

Visual Basic Public ReadOnly Property RecognizerConfidence As Single 
C# public float RecognizerConfidence { get; } 

Managed C++ public: property float getJRecognizerConfidenceO; 

JScript public function get RecognizerConfidenceQ : float 

Property Value 

System.Single. 
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This property is read-only. 
Remarks 

This value is not standardized across multiple speech Recognizers and can even change 
from version to version of a specific recognizer. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Rules Property 

Note: This documentation is preliminary and is subject to change. 

Gets the RulesCollection returned by the Rules property. If this rule was constructed by referencing 
other rules, the referenced rules are contained in the collection. 
* 

Definition 

Visual Basic Public ReadOnly Property Rules As RecognitioaRuIeCollection 
C# public RecognitionRuleCoIlection Rules { get; } 

Managed C++ public: property RecognitionRuleCoIlection * get RulesO; 

JScript public function get RulesO : RecognitionRuleCoIlection 

Property Value 

System.Speech.Recognition.RecognitionRuleCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 

Gets the display text for the recognition result that this rule encompasses. 

Definition 

Visual Basic Public ReadOnly Property Text As String 

C# public strin g Text { get; } 
Managed C++ public: property Strin g* get_TextQ; 
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JScript public function get Text() : String 
Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation, All rights reserved Terms of use. 

Tokens Property 

Note: This documentation is preliminary and is subject to change. 

Gets the set of tokens for the recognition result that this rule encompasses. 

Definition 

Visual Basic Public ReadOnly Property Tokens As SpokenTokenCollection 
C# public SpokenTokenCollection Tokens { get; } 

Managed C++ public: property SpokenTokenCollection * getJTokensO; 

JScript public function get TokensO : SpokenTokenCollection 

Property Value 

System.Speech.Recognition.SpokenTokenCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionRuleCollection Class 

Note: This documentation is preliminary and is subject to change. 

Provides a collection of rules. 

Definition 

Visual Public Class RecognitionRuleCollection 
Basic Inherits ReadOnlyCollectionBase 

C# public class RecognitionRuleCollection : ReadOnlyCollectionBase 
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Managed public gc 

C++ class RecognitionRuleCollection : public ReadOnlyCollectionBase 

JScript public class RecognitionRuleCollection extends ReadOnlyCollectionBase 



Members Table 
Inheritance Hierarchy 



Object 



HI Leave 



ReadOnlyCollectionBase 



El Leave 



RecognitionRuleCollection 

Class Information 

Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture^Tieutral, 

Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

get_Item Method 

Note: This documentation is preliminary and is subject to change. 
Overload List 

public RecognitionRule getjtem (String) 
public RecognitionRule get Item flnt32) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 

Note: This documentation is preliminary and is subject to change. 
Gets the rule at the specified position. 
Overload List 
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public RecognitionRule Item (Tnt32) 
public RecognitionRule Item (String) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeCompletedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 
Provides event arguments for the RecognizeCompleted event. 
Definition 

Public Class RecognizeCompletedEventArgs 

Visual Inherits err! bad xref: 

Basic frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic: lookup 
failure; no href; no caption; 

public class RecognizeCompletedEventArgs : err! bad xref: 
C# MrfSystemComponentModelAsyncCompletedEventArgsClassTopic: lookup 
failure; no href; no caption; 

public gc class RecognizeCompletedEventArgs : public err! bad xref: 

frlrfSystemComponentModelAsyncCompletedEventArgsClassTopi^ lookup 
failure; no href; no caption; 

public class RecognizeCompletedEventArgs extends err! bad xref: 
JScript frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic: lookup 
failure; no href; no caption; 

Members Table 



Inheritance Hierarchy 



err! bad xref: frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic ; 
lookup failure; no href; no caption; 

RecognizeCompletedEventArgs 

Class Information 

Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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RecognizeCompletedEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the RecognizeCompletedEventArgs class. 
Definition 

Public Sub RecognizeCompIetedEventArgs( _ 

ByVal error As Exception , _ 
Visual Basic ByVal cancelled As Boolean , _ 
v. lL J * A ByVal userToken As Object _ 

ByVal result As RecognitionResult _ 

) 

public RecognizeCompletedEventArgs( 
Exception error, 
£2 bool cancelled, 

object userToken, 
RecognitionResult result 

); 

public: RecognizeCompletedEventArgs( 
Exception * error, 

Man a ed C++ ^ool cancelled, 

* Object * userToken, 

RecognitionResult * result 

); 

public function RecognizeCompletedEventArgs( 
error : Exception . 
T „ . cancelled : boolean . 

P userToken : Object 

result : Recog nitionResult 

); 

Parameters 

error System.Exception. 
cancelled System.BooIean. 
userToken System.Object 

result System.Speech.Recognition.RecognitionResult Result representing the last 
f u ' u recognized phrase. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Result Property 
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Note: This documentation is preliminary and is subject to change. 

Gets the recognition result. 

Definition 

Visual Basic Public ReadOnly Property Result As RecognitionResult 



Managed C++ public: property RecognitionResult * get_Result(); 

JScript public function get Result() : RecognitionResult 

Property Value 

System.Speech.Recognition.RecognitionResult. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



RecognizeProgressChangedEventArgs Class 



Note: This documentation is preliminary and is subject to change. 
Provides data for the RecognizeProgressChanged event. 
Definition 

Visual Public Class RecognizeProgressChangedEventArgs 
Basic Inherits SpeechEventArg s 

C# public class RecognizeProgressChangedEventArgs : SpeechEventArg s 

Managed public gc 

C++ class RecognizeProgressChangedEventArgs : public SpeechEventArg s 

JScript public class RecognizeProgressChangedEventArgs extends SpeechEventArgs 
Members Table 
Inheritance Hierarchy 



C# 



public RecognitionResult Result { get; } 



Object 



3 Leave 



xj Leave 
EventArgs L_ 



SpeechEventArgs 

RecognizeProgressChangedEventArgs 
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Class Information 

Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeProgressChangedEventArgs Method 



Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the AudioContentChangedEventArgs class. 
Definition 

Public Sub RecognizeProgressChangedEventArgs( _ 

ByVal audioPosition As TimeSpan , _ 
Visual Basic ByVal recognizerPosition As TimeSpan , _ 
ByVal audioLevel As Integer _ 

) 

public RecognizeProgressChangedEventArgs( 
TimeSpan audioPosition, 
C# TimeSpan recognizerPosition, 

int audioLevel 

); 

public: RecognizeProgressChangedEventArgs( 
TimeSpan audioPosition, 
Managed C++ TimeSpan recognizerPosition, 
int audioLevel 

); 

public function RecognizeProgressChangedEventArgs( 

audioPosition : TimeSpan , 
JScript recognizerPosition : TimeSpan , 
audioLevel : int 

Parameters 

audioPosition System.TimeSpan. 
recognizerPosition System.TimeSpan. 
audioLevel System.Int32. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioLevel Property 

Note: This documentation is preliminary and is subject to change. 

Gets the old audio state. 

Definition 

Visual Basic Public ReadOnly Property AudioLevel As Integer 
C# public mt AudioLevel { get; } 

Managed C++ public: property int get_AudioLevel(); 

JScript public function get AudioLevelO : int 

Property Value 

System.Int32. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerPosition Property 

Note: This documentation is preliminary and is subject to change. 

Gets the recognizer position in the audio stream at the time the event is raised. 

Definition 

Visual Basic Public ReadOnly Property RecognizerPosition As TimeSpan 
C# public TimeSpan RecognizerPosition { get; } 

Managed C++ public: property TimeSpan get_RecognizerPosition(); 

JScript public function get RecognizerPositionQ : TimeSpan 

Property Value 

System.TimeSpan. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognizer Attributes Class 

Note: This documentation is preliminary and is subject to change. 
Represents the attributes various speech recognizers may, or may not support. 
Definition 

, 7 . 1T . . Public Class RecognizerAttributes 
Visual Basic T u . ° 

Inherits Object 

C# public class RecognizerAttributes : Object 

Managed C++ public gc class RecognizerAttributes : public Object 

JScript public class RecognizerAttributes extends Object 

Members Table 
Inheritance Hierarchy 



Object 



□ Leave 



RecognizerAttributes 

Remarks 

If this object is created directly, then trying to get properties that are not set yet will throw 
an exception. If this object is obtained from a recognizer then it is read-only and trying to 
set will have no effect. 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetCustomAttribute Method 



Note: This documentation is preliminary and is subject to change. 
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Gets the specified custom recognizer attribute. 
Definition 

Public Function GetCustomAttribute( 
Visual Basic ByVal attributeName As String _ 
) As String 

public string GetCustomAttributef 
C# string attributeName 

); 

public: String * GetCustomAttribute( 
Managed C++ String * attributeName 

); 

public function GetCustomAttribute( 
JScript attributeName : String 
): String; 

Parameters 

attributeName System.String. 
Return Value 

System.String. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DisplayName Property 



Note: This documentation is preliminary and is subject to change. 

Gets the display name of the recognizer. 

Definition 

Visual Basic Public ReadOnly Property DisplayName As String 
C# public string DisplayName { get; } 

Managed C++ public: property String * getDisplayNameQ; 

JScript public function get DisplayName() : String 

Property Value 

System.String. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Id Property 

Note: This documentation is preliminary and is subject to change. 

Gets the unique ID of this recognizer. 

Definition 

Visual Basic Public ReadOnly Property Id As String 
C# public string Id { get; } 

Managed C++ public: property String * get_Id(); 

JScript public function get IdQ : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsVendorPreferred Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies, if multiple recognizers are installed on the machine by the same vendor, 
whether this recognizer is the one preferred by the vendor. 

Definition 

Visual Basic Public ReadOnly Property IsVendorPreferred As Boolean 
C# public bool IsVendorPreferred { get; } 

Managed C++ public: property bool getlsVendorPreferredO; 

JScript public function get IsVendorPreferredQ : boolean 

Property Value 

System.Boolean. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Languages Property 

Note: This documentation is preliminary and is subject to change. 
Gets the Culturelnfo IDs of the languages this engine recognizes. 
Definition 

Visual Basic Public ReadOnly Property Languages As Culturelnfo Class Q 

C# public Culturelnfo Class [] Languages { get; } 
Managed C++ public: property Culturelnfo Class * getJLanguagesO; 
JScript public function get Languages() : Culturelnfo Class [] 

Property Value 

System.Globalization.Culturelnfo. 

This property is read-only. 

© 2003 Microsoft Corporation. . All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 
Gets the name of the recognizer. 
Definition 

Visual Basic Public ReadOnly Property Name As String 
C# public string Name { get; } 

Managed C++ public: property String * getJVameO; 

JScript public function get Name() String 

Property Value 

System.String. 
This property is read-only. 



2/3/04 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportedAudioFormats Property 

Note: This documentation is preliminary and is subject to change. 

Gets the audio formats this engine supports. 

Definition 

Visual Basic Public ReadOnly Property SupportedAudioFormats As Object Q 
C# public object [] SupportedAudioFormats { get; } 

Managed C++ public: property Object * get SupportedAudioFormatsO; 

JScript public function get SupportedAudioFormatsO * Object [] 

Property Value 

System.Object. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsCommandAlternates Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports alternates for command and control results. 
Definition 

Visual Basic Public ReadOnly Property SupportsCommandAlternates As Boolean 
C# public boo! SupportsCommandAlternates { get; } 

Managed C++ public: property bool getSupportsCommandAlternatesO; 

JScript public function get SupportsCommandAlternates() : boolean 

Property Value r 
System.Boolean. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsCommands Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports command and control 

Definition 

Visual Basic Public ReadOnly Property SupportsCommands As Boolean 
C# public bool SupportsCommands { get; } 

Managed C++ public: property bool getjSupportsCommandsO; 

JScript public function get SupportsCommandsO : boolean 

Property Value 

System.BooIean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsContinuousRecognition Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports continuous recognition, which does not 
require pauses between words. 

Definition 

Visual Basic Public ReadOnly Property SupportsContinuousRecognition As Boolean 
C# public bool SupportsContinuousRecognition { get; } 

Managed C++ public: property bool getSupportsContinuousRecognitionQ; 

JScript public function get SupportsContinuousRecognitionO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 
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© 2003 Microsoft Corporation, All ri g hts reserved. Terms of use. 

SupportsDesktop Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports desktop audio input. 

Definition 

Visual Basic Public ReadOnly Property SupportsDesktop As Boolean 
C# public bool SupportsDesktop { get; } 

Managed C++ public: property bool getJSupportsDesktopQ; 

JScript public function get SupportsDesktopO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsDictation Property 

Note: This documentation is preliminary and is subject to change. 
Gets a value that specifies whether the recognizer supports dictation. 
Definition 

Visual Basic Public ReadOnly Property SupportsDictation As Boolean 
C# public bool SupportsDictation { get; } 

Managed C++ public: property bool get_SupportsDictation(); 

JScript public function get SupportsDictationO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsDictationAlternates Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports alternates for dictation results. 

Definition 

Visual Basic Public ReadOnly Property SupportsDictationAlternates As Boolean 
C# public bool SupportsDictationAlternates { get; } 

Managed C++ public: property bool get_SupportsDictationAlternates(); 

JScript public function get SupportsDictationAlternates() : boolean 

Property Value 

System.Boolean. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsDictationlnCfgAnywhere Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports dictation transitions in context-free grammar 
recognition anywhere in the rule. 

Definition 

Visual Basic Public ReadOnly Property SupportsDictationlnCfgAnywhere As Boolean 
C# public bool SupportsDictationlnCfgAnywhere { get; } 

Managed public : property bool getSupportsDictationlnCfgAny where(); 

JScript public function get SupportsDictationInCfgAnywhere() : boolean 

Property Value 

System.Boolean. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsDiscreteRecognition Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports discrete recognition, which requires pauses 
between words. 

Definition 

Visual Basic Public ReadOnly Property SupportsDiscreteRecognition As Boolean 
C# public bool SupportsDiscreteRecognition { get; } 

Managed C++ public: property bool get_SupportsDiscreteRecognition(); 

JScript public function get SupportsDiscreteRecognition() : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsHypotheses Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports sending hypotheses before final recognition. 
Definition 

Visual Basic Public ReadOnly Property SupportsHypotheses As Boolean 
C# public bool SupportsHypotheses { get; } 

Managed C++ public: property bool get_SupportsHypotheses(); 

JScript public function get SupportsHypothesesO : boolean 

Property Value 

System.Boolean. 
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This property is read-only. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsMobileDevice Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer is tuned for use on a hand-held device. 

Definition 

Visual Basic Public ReadOnly Property SupportsMobileDevice As Boolean 
C# public bool SupportsMobileDevice { get; } 

Managed C++ public: property bool get_SupportsMobileDevice(); 

JScript public function get SupportsMobileDevice() : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsRemoteDevice Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer is tuned to recognize audio streamed from a device to 
a server. 

Definition 

Visual Basic Public ReadOnly Property SupportsRemoteDevice As Boolean 
C# public bool SupportsRemoteDevice { get; } 

Managed C++ public: property bool get_SupportsRemoteDevice(); 

JScript public function get SupportsRemoteDevice() : boolean 

Property Value 

System.Boolean. 
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This property is read-only. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsTelephony Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports telephony audio input. 

Definition 

Visual Basic Public Readonly Property SupportsTelephony As Boolean 
C# public bool SupportsTelephony { get; } 

Managed C++ public: property bool getSupportsTelephonyO; 

JScript public function get SupportsTelephony() : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsTrailingDictationlnCfg Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports dictation in context-free grammar 
recognition anywhere in the rule. 

Definition 

Visual Basic Public ReadOnly Property SupportsTrailingDictationlnCfg As Boolean 
C# public bool SupportsTrailingDictationlnCfg { get; } 

Managed C++ public: property bool get SupportsTrailingDictationlnCfgO; 

JScript public function get SupportsTrailingDictationlnCfgO • boolean 

Property Value 

System.Boolean. 
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This property is read-only. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

SupportsTrailingWildcardlnCfg Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports wildcard transitions in context-free grammar 
recognition at the end of the rule. 

Definition 

Visual Basic Public Readonly Property SupportsTrailingWildcardlnCfg As Boolean 
C# public bool SupportsTrailingWildcardlnCfg { get; } 

Managed C++ public: property bool get SupportsTrailingWildcardInCfg(); 

JScript public function get SupportsTrailingWildcardlnCfgO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsTrailingWordSequences Property 

Note: This documentation is preliminary, and is subject to change. 

Gets a value that specifies whether the recognizer supports word sequences in context-free grammar 
recognition at the end of the rule. 

Definition 

Visual Basic Public ReadOnly Property SupportsTrailingWordSequences As Boolean 
C# public bool SupportsTrailingWordSequences { get; } 

Managed C++ public: property bool get SupportsTrailingWordSequences(); 

JScript public function get SupportsTrailingWordSequencesQ : boolean 

Property Value 
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System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Supports WildeardlnCfgAnywhere Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports wildcard transitions in context-free grammar 
recognition anywhere in the rule. 

Definition 

Visual Basic Public Readonly Property Supports WildeardlnCfgAnywhere As Boolean 
C# public bool Supports WildeardlnCfgAnywhere { get; } 

Managed public : property bool getSupports WildcardlnCfgAnywhereO; 

JScript public function get Supports WildcardlnCfgAnywhereO : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SupportsWordSequencesAnywhere Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer supports word sequences in context-free grammar 
recognition anywhere in the rule. 

Definition 

Visual Basic Public ReadOnly Property SupportsWordSequencesAnywhere As Boolean 
C# public bool SupportsWordSequencesAnywhere { get; } 

^C^+ C( * Public: property bool get SupportsWordSequencesAnywhereQ; 
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JScript public function get Supports WordSequencesAnywhereQ : boolean 

Property Value 

System.Boolean. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Vendor Property 

Note: This documentation is preliminary and is subject to change. 
Gets the company name of the vendor that authored the recognizer. 
Definition 

Visual Basic Public ReadOnly Property Vendor As String 
C# public string Vendor { get; } 

Managed C++ public: property String * get_Vendor(); 

JScript public function get Vendor() : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerProperties Class 

Note: This documentation is preliminary and is subject to change. 
Represents recognizer properties that are adjustable at runtime. 
Definition 

. „ Public Class RecognizerProperties 
Visual Basic x u ~ u . * r 

Inherits Object 

C# public class RecognizerProperties : Object 
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Managed C++ public gc class RecognizerProperties : public Object 

JScript public class RecognizerProperties extends Object 

Members Table 
Inheritance Hierarchy 



Object 



3 Le ^ve 



RecognizerProperties 

Class Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetProperty Method 



Note: This documentation is preliminary and is subject to change. 
Gets a property from the underlying recognizer object. 
Definition 

Public Function GetProperty( _ 
Visual Basic ByVal propertyName As String _ 
) As Object 

public obj ect GetProperty( 
C# string propertyName 

); 

public: Obj ect* GetProperty( 
Managed C++ String * propertyName 

); 

public function GetProperty( 
JScript propertyName : String 
) : Object ; 

Parameters 

propertyName System.String. The Name of the property to get 
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Return Value 

System.Object. 

The value of the property 
Remarks 

If the underlying Recognizer does not support this property, an exception will be thrown. 
The property is returned as an object, since the property can either be a string or a long. It is 
up to the caller to convert this object into the appropriate type (e.g. long 1 = GetProperty 
("foo") as long;) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SetProperty Method 

Note: This documentation is preliminary and is subject to change. 
Sets a property on the underlying recognizer object. 
Overload List 

public Void SetProperty (String, String ) 
public Void SetProperty (String, Int32) 

Remarks 

If the underlying Recognizer does not support this property, an exception will be thrown. 
If the underlying Recognizer does not support this property, an exception will be thrown. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ComplexResponseSpeed Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the amount of time in milliseconds that defines the end of a recognition, when the 
recognition is ambiguous. 

Definition 
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Visual Basic Public Property ComplexResponseSpeed As TimeSpan 
C# public TimeSp an ComplexResponseSpeed { get; set; } 

Mana ed C++ P u ^^ c: property TimeSp an get ComplexResponseSpeedQ; 

a * public: property void set ComplexResponseSpeed( TimeSpan ); 

to • f public function get ComplexResponseSpeedO : TimeSpan 
Cnp public function set CompIexResponseSpeed (TimeSpan) ; 

Property Value 

System.TimeSpan. 

This property is read/write. 
Remarks 

This attribute is used when the recognition is ambiguous. For example, in the case of a CFG 
which has two sentences: 1) new game please and 2) new game, an ambiguous recognition 
would be new game. This property's value must be greater than the ResponseSpeed value. If 
the underlying Recognizer does not support this property, an exception will be thrown. 
Range: 0 - 10,000 ms, default 500 ms 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

HighConfidenceThreshold Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the boundary between the high and medium confidence range. 

Definition 

Visual Basic Public Property HighConfidenceThreshold As Integer 
C# public int HighConfidenceThreshold { get; set; } 

„ , r public: property int get_HighConfidenceThreshold(); 

Managed C++ pu blic: _property void set_HighConfidenceThreshold(int); 

to • f public function get HighConfidenceThresholdQ : int 
C P public function set HighConfidenceThreshold(mt); 

Property Value 

System.Int32. 

This property is read/write. 
Remarks 
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The location of the low confidence, normal confidence, and high confidence markers 
control how the confidence of a word is labeled. The HighConfidenceThreshold (HCT) 
separates the high and medium confidence range. The NormalConfidenceThreshold (NCT) 
separates the medium and the low confidence thresholds. The LowConfidenceThreshold 
(LCT) separates the low and rejected confidence range. If the all three confidences are equal 
to 0, then all words will have high confidence. If all three confidences are equal to 100, then 
all words will have low confidence. If the underlying Recognizer does not support this 
property, an exception will be thrown. Range: 0-100, default 80 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsAdaptationOn Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets a value that indicates whether the recognition engine should adapt the acoustic model. 
Definition 

Visual Basic Public Property IsAdaptationOn As Boolean 
C# public bool IsAdaptationOn { get; set; } 

Managed C++ P ublic: Property bool get_IsAdaptationOn(); 

" public: property void set_IsAdaptationOn(booI); 

„ . public function get IsAdaptationOnO * boolean 
cnp public function set Is AdaptationOn( boolean ) ; 

Property Value 

System.Boolean. 

This property is read/write. 
Remarks 

If the underlying Recognizer does not support this property, an exception will be thrown. 
Default: true 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

LowConfidenceThreshold Property 



Note: This documentation is preliminary and is subject to change. 



omc\A 



Interacting with the Computer using Speech Input and Speech Output Page 131 of 357 

Gets and sets the boundary between the low and rejected confidence range. 
Definition 

Visual Basic Public Property LowConfidenceThreshold As Integer 
C# public int LowConfidenceThreshold { get; set; } 

Mana ed C++ pu ^ c: property int getLowConfidenceThresholdO; 

an g public: property void setLowConfidenceThreshold(int); 

T « . public function get LowConfidenceThreshoId0 : int 
ip public function set LowConfidenceThreshold(int); 

Property Value 

System.Int32. 

This property is read/write. 
Remarks 

The location of the low confidence, normal confidence, and high confidence markers 
control how the confidence of a word is labeled. The HighConfidenceThreshold (HCT) 
separates the high and medium confidence range. The NormalConfidenceThreshold (NCT) 
separates the medium and the low confidence thresholds. The LowConfidenceThreshold 
(LCT) separates the low and rejected confidence range. If the all three confidences are equal 
to 0, then all words will have high confidence. If all three confidences are equal to 100, then 
all words will have low confidence. If the underlying Recognizer does not support this 
property, an exception will be thrown. Range: 0-100, default 20 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

NormalConfidenceThreshold Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the boundary between the medium and low confidence range. 

Definition 

Visual Basic Public Property NormalConfidenceThreshold As Integer 
C# public int NormalConfidenceThreshold { get; set; } 

Mana ed C++ P ubl * c: P r0 P ert Y "ll get_NormalConfidenceThreshold(); 

8 public: property void set NormalConfidenceThreshold(int): 

T c • f public function get NormalConfidenceThresholdQ : int 
p public function set NormalConfidenceThreshold(int): 
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Property Value 

System.Int32. 

This property is read/write. 
Remarks 

The location of the low confidence, normal confidence, and high confidence markers 
control how the confidence of a word is labeled. The HighConfidenceThreshold (HCT) 
separates the high and medium confidence range. The NormalConfidenceThreshold (NCT) 
separates the medium and the low confidence thresholds. The LowConfidenceThreshold 
(LCT) separates the low and rejected confidence range. If the all three confidences are equal 
to 0, then all words will have high confidence. If all three confidences are equal to 100, then 
all words will have low confidence. If the underlying Recognizer does not support this 
property, an exception will be thrown. Range: 0-100, default 50 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Note: This documentation is preliminary and is subject to change. 

Gets and sets CPU resource consumption. As resource usage increases, so does the use of CPU 
resources. 



ResourceUsage Property 



Definition 



Managed C++ 



Visual Basic 
C# 



JScript 



Public Property ResourceUsage As Inte ger 

public hit ResourceUsage { get; set; } 

public: property int get_ResourceUsage(); 

public: property void set ResourceUsage(int): 

public function get ResourceUsageO : int 
public function set ResourceUsage(int): 



Property Value 



System.Int32. 



This property is 



read/write. 



Remarks 



If the underlying Recognizer does not support this property, an exception is thrown. Range: 
0-100, default 50. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

ResponseSpeed Property 



Note: This documentation is preliminary and is subject to change. 

Gets and sets the amount of time in milliseconds that defines the end of a recognition, when the 
recognition is not ambiguous. 

Definition 

Visual Basic Public Property ResponseSpeed As TimeSpan 
C# public TimeSpan ResponseSpeed { get; set; } 

Mana ed C++ P u ^ c: property TimeSpan getResponseSpeedO; 

* public: property void setResponseSpeed( TimeSp an); 

tc • f public function get ResponseSpeedO • TimeSpan 
P public function set ResponseSpeed( TimeSp an); 

Property Value 

System.TimeSpan. 

This property is read/write. 
Remarks 

This attribute is used when the recognition is not ambiguous. For example, in the case of a 
context-free grammar (CFG) which has two sentences: 1) new game please and 2) new 
game, a non-ambiguous recognition would be new game please. If the underlying 
Recognizer does not support this property, an exception will be thrown. Range: 0 - 10,000 
ms, default 150 ms 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognizers Class 

Note: This documentation is preliminary and is subject to change. 

Represents a collection of speech recognizers. 

Definition 

Visual Basic Public Class Recognizers 
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Inherits ReadOnlyCollectionBase 
C# public class Recognizers : ReadOnlyCollectionBase 

Managed C++ public gc class Recognizers : public ReadOnlyCollectionBase 

JScript public class Recognizers extends ReadOnlyCollectionBase 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



ReadOnlyCollectionB ase 



3 Leave 



Recognizers 

Remarks 

This class can't be created directly, but is obtained from the static AvailableRecognizers 
fields or GetAvailableRecognizers method. 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AvailableRecognizers Property 



Note: This documentation is preliminary and is subject to change. 
Gets the attributes of all the recognizers that are installed on the system. 
Definition 

Visual Basic Public Shared ReadOnly Property AvailableRecognizers As Recognizers 
C# public static Recognizers AvailableRecognizers { get; } 

Managed C++ public: property static Recognizers * getAvailableRecognizersO; 

JScript public static function get AvailableRecognizersQ • Recognizers 

Property Value 
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System.Speech.Recognition.Recognizers. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 

Note: This documentation is preliminary and is subject to change. 

Gets the specified attribute. 

Definition 

Public ReadOnly Property Item( _ 
Visual Basic ByVal index As Integer _ 
) As Recognizer Attributes 

public RecognizerAttributes this[ 
C# int index 

]{get;} 

public: property RecognizerAttributes * get_Item( 

Managed C++ int index 

); . 

JScript In JScript, you can use indexed properties, but you cannot define your own. 
Property Value 

« 

System.Speech.Recognition.RecognizerAttributes. 

This property is read-only. 
Parameters 

index System.Int32. The zero-based index of the desired attribute. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerStateChangedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 
Provides data for the RecognizerStateChanged event. 
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Definition 

Visual Public Class RecognizerStateChangedEventArgs 
Basic Inherits SpeechEventArgs 

C# public class RecognizerStateChangedEventArgs : SpeechEventArgs 

Managed public gc 

C++ class RecognizerStateChangedEventArgs : public SpeechEventArgs 

JScript public class RecognizerStateChangedEventArgs extends SpeechEventArgs 

Members Table 
Inheritance Hierarchy 



Object 



5 Leave 



EventArgs 



3 Leave 



SpeechEventArgs 

RecognizerStateChangedEventArgs 

Class Information 

Namespace System. Speech.Recoghition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 1 43bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerStateChangedEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the RecognizerStateChangedEventArgs class. 
Definition 

Public Sub RecognizerStateChangedEventArgs( _ 
Visual Basic ByVal audioPosition As TimeSpan . _ 
* iAb 1 By Val state As RecognizerState _ 

) 

public RecognizerStateChangedEventArgs( 
^ TimeSpan audioPosition, 

RecognizerState state 

); 

fi1p^/rAWTMnnWS\TP.MP\~hhF.F.AQ htm 2/3/04 



Interacting with the Computer using Speech Input and Speech Output 



Page 137 of 357 



public: RecognizerStateChangedEventArgs( 



Managed C++ 



TimeSpan audioPosition, 



RecognizerState state 

); 

public function RecognizerStateChangedEventArgs( 



JScript 



audioPosition : TimeSpan . 



state : RecognizerState 

); 



Parameters 



audioPosition 



System.TimeSpan. Placeholder 
System.Speech.Recognition.RecognizerState. 



state 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Note: This documentation is preliminary and is subject to change. 

Gets the updated audio state. 

Definition 

Visual Basic Public ReadOnly Property State As RecognizerState 



Managed C++ public: property RecognizerState get_State(); 

JScript public function get StateO : RecognizerState 

Property Value 

System.Speech.Recognition.RecognizerState. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Note: This documentation is preliminary and is subject to change. 
Represents a grammar rule. 



State Property 



c# 



public RecognizerState State { get; } 



Rule Class 
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Definition 

tr . lin . Public Class Rule 
Visual Basic T u ^, . . 

Inhents Object 

C# public class Rule : Object 

Managed C++ public gc class Rule : public Object 

JScript public class Rule extends Object 

Members Table 
Inheritance Hierarchy 



Object 



xj Leave 



Rule 

Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Rule Method 

Note: This documentation is preliminary and is subject to change. 

Initializes a new instance of the Rule class. 

Definition 

Visual Basic Public Sub Rule() 

C# public Rule(); 
Managed C++ public: Rule(); 

JScript public function RuleQ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsActive Property 
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Note: This documentation is preliminary and is subject to change. 

Gets or sets the state of a grammar rule. 

Definition 

Visual Basic Public Property IsActive As Boolean 
C# public bool IsActive { get; set; } 

Managed C++ public: -P 0 ?*® ^ get JsActivcO; 

5 public: property void setlsActive( bool ); 

. public function get IsActiveQ : boolean 
P public function set IsActive( boolean ); 

Property Value 

System.Boolean. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use, . 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets the name of the rule. 

Definition 

Visual Basic Public ReadOnly Property Name As String 
C# public string Name { get; } 

Managed C++ public: property String * get_Name(); 

JScript public function get Name() : Strin g 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleCollection Class 
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Note: This documentation is preliminary and is subject to change. 

Represents a collection of Rules. 

Definition 

. Public Class RuleCollection 
v isuai oasie ReadOnlyCollectionBase 

C# public class RuleCollection : ReadOnlyCollectionBase 

Managed C++ public gc class RuleCollection : public ReadOnlyCollectionBase 

JScript public class RuleCollection extends ReadOnlyCollectionBase 



Members Table 



Inheritance Hierarchy 



Object 



3 Leave 



ReadOnlyCollectionBase 
RuleCollection 



x] Leave 



Class Information 



Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

getjttem Method 



Note: This documentation is preliminary and is subject to change. 
Overload List 

public Rule get_Item (String) 
public Rule get_Item (Int32) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Item Property 



Note: This documentation is preliminary and is subject to change. 
Gets the specified rule. 



Overload List 



public Rule Item Qnt32) 
public Rule Item (String) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SemanticProperty Class 

Note: This documentation is preliminary and is subject to change. 

Represents a single semantic property that may contain additional levels of semantic information. 



Definition 



. Public Class SemanticProperty 
Visual Basic ^^\s Object 

C# public class SemanticProperty : Object 

Managed C++ public gc class SemanticProperty : public Object 

JScript public class SemanticProperty extends Object 



Members Table 



Inheritance Hierarchy 



Object 



0 Leave 



SemanticProperty 

Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 1 43bb27e7ac8b 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Confidence Property 

Note: This documentation is preliminary and is subject to change. 
Gets the confidence score information relating to the semantic property. 
Definition 

Visual Basic Public ReadOnly Property Confidence As Confidence 
C# public Confidence Confidence { get; } 

Managed C++ public: property Confidence getConfidenceO; 

JScript public function get ConfidenceO : Confidence 

Property Value 

System.Speech.Recognition.Confidence. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets the name of this semantic property. 

Definition 

Visual Basic Public ReadOnly Property Name As String 
C# public string Name { get; } 

Managed C++ public: property String * get_Name(); 

JScript public function get NameO : String 

Property Value 

System.String. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Properties Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of child semantic properties of this property. 
Definition 

Visual Basic Public ReadOnly Property Properties As SemanticPropertyCoIlection 
C# public SemanticPropertyCoIlection Properties { get; } 

Managed C++ public: property SemanticPropertyCoIlection * get_Properties(); 

JScript public function get PropertiesO : SemanticPropertyCoIlection 

Property Value 

System.Speech.Recognition.SemanticPropertyCoIlection. 

This property is read-only. 

© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

RecognizerConfidence Property 

Note: This documentation is preliminary and is subject to change. 

Gets the confidence value for this semantic property computed by the speech recognition engine. 
Definition 

Visual Basic Public ReadOnly Property RecognizerConfidence As Single 
C# public float RecognizerConfidence { get; } 

Managed C++ public: property float getRecognizerConfidenceO; 

JScript public function get RecognizerConfidenceO " float 

Property Value 

System.Single. 

This property is read-only. 



Interacting with the Computer using Speech Input and Speech Output Page 144 of 357 

© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 

Gets the text of this semantic property. 

Definition 

Visual Basic Public ReadOnly Property Text As String 
C# public string Text { get; } 

Managed C++ public: property String * get_Text(); 

JScript public function get TextO : String 

Property Value 

System.String. 

This property is read-only. 
Remarks 

For example, for the Solitaire PlayCard rule, the Text for the Rank property may be "ace", 
"two", "three", etc. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Tokens Property 

Note: This documentation is preliminary and is subject to change. 
Gets the tokens that correspond to this semantic property. 
Definition 

Visual Basic Public ReadOnly Property Tokens As S pokenTokenCoIlection 
C# public S pokenTokenCoIlection Tokens { get; } 

Managed C++ public: property S pokenTokenCoIlection * get_Tokens(); 

JScript public function get TokensO ■ SpokenTokenCoIlection 

Property Value 
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System.Speech.Recognition.SpokenTokenColIection. 

This property is read-only. 
Remarks 

For example, for the Solitaire PlayCard rule, the Tokens collection for the Rank property 
probably just contains one token, and it could contain "ace", "two", "three", etc. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Value Property 

Note: This documentation is preliminary and is subject to change. 

Gets the value of this semantic property. 

Definition 

Visual Basic Public ReadOnly Property Value As Object 
C# public object Value { get; } 

Managed C++ public: property Object* get_Value(); 

JScript public function get ValueO : Object 

Property Value 

System.Object. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SemanticPropertyCollection Class 

Note: This documentation is preliminary and is subject to change. 

Represents a collection of semantic properties. 

Definition 

Visual Public Class SemanticPropertyCollection 
Basic Inherits ReadOnly CollectionBase 

C# public class SemanticPropertyCollection : ReadOnly CollectionBase 
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Managed public gc 

C++ class SemanticPropertyCollection : public ReadOnlyCollectionBase 

JScript public class SemanticPropertyCollection extends ReadOnlyCollectionBase 

Members Table 
Inheritance Hierarchy 



Object 



xj Leave 



ReadOnlyCollectionBase 



3 Leave 



SemanticPropertyCollection 

Class Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 1 43bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

getltem Method 

Note: This documentation is preliminary and is subject to change. 
Overload List 

public SemanticProperty get_Item (String) 
public SemanticProperty get_Ite m (Int32) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 

Note: This documentation is preliminary and is subject to change. 
Gets the specified SemanticProperty. 
Overload List 
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public SemanticProperty Item (Int32) 
public SemanticProperty Item (String) 



© 2003 Microsoft Corporation. All rights reserved Terms of use. 

SpeechEventArgs Class 



Note: This documentation is preliminary and is subject to change. 

Provides data for these events: NoRecognition, AudioLevelChanged, RecognitionStarted, 
RecognitionStopped, RecognitionCanceled, RecognitionPaused, and RecognitionResumed. 

Definition 

Visual Basic ^ u ^^ c Class SpeechEventArgs 

Inherits EventArgs 

C# public class SpeechEventArgs : EventArg s 

Managed C++ public gc class SpeechEventArgs : public EventArgs 

JScript public class SpeechEventArgs extends EventArgs 

Members Table 
Inheritance Hierarchy 



Object 



~x\ Leave 



EventArgs 



[xj Leave 



SpeechEventArgs 

ActiveCategoryChangedEventArgs 

AudioContentChangedEventArgs 

BookmarkEventArgs 

CommandRecognitionEventArgs 

InterferenceEventArgs 

RecognitionEventArgs 

RecognizeProgressChangedEventArgs 

RecognizerStateChangedEventArgs 

UpdateEventArgs 



Class Information 



Namespace System. Speech.Recogniti on 
Assembly System.Speech (system.speech.dll) 



mind. 
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Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeechEventArgs Method 



Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the SpeechEventArgs class. 
Definition 

Public Sub SpeechEventArgs( _ 
Visual Basic ByVal audioPosition As TimeSpan _ 

) 

public SpeechEventArgs( 
C# TimeSp an audioPosition 

); 

public: SpeechEventArgs( 
Managed C++ TimeSpan audioPosition 

); 

public function SpeechEventArgs( 
JScript audioPosition : TimeSpan 

); 

Parameters 

audioPosition System.TimeSpan. Placeholder 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioPosition Property 



Note: This documentation is preliminary and is subject to change. 
Gets the time the event occurred, relative to the start of the stream. 
Definition 

Visual Basic Public ReadOnly Property AudioPosition As TimeSpan 
C# public TimeSpan AudioPosition { get; } 
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Managed C++ public: property TimeSpan get_AudioPosition(); 

JScript public function get AudioPosition() : TimeSpan 

Property Value 

System.TimeSpan. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpokenToken Class 



Note: This documentation is preliminary and is subject to change. 

Represents a token, in western languages this is typically a word , that was recognized by the speech 
recognizer. 

Definition 

™ , n . Public Class SpokenToken 
Visual Basic T , + 

Inherits Object 

C# public class SpokenToken : Object 

Managed C++ public gc class SpokenToken : public Object 

JScript public class SpokenToken extends Object 

Members Table 
Inheritance Hierarchy 



Obj ect 



^xj Leave 



SpokenToken 

Class Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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ToString Method 

Note: This documentation is preliminary and is subject to change. 

Gets the spoken text of the token. 

Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : Strin g; 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Audio Property 

Note: This documentation is preliminary and is subject to change. 
Gets the captured audio that corresponds to this recognized token. 
Definition 

Visual Basic Public ReadOnly Property Audio As Recognition Audio 
C# public RecognitionAudio Audio { get; } 

Managed C++ public: property RecognitionAudio * get AudioO; 

JScript public function get AudioO : RecognitionAudio 

Property Value 

System.Speech.Recognition.RecognitionAudio. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Confidence Property 
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Note: This documentation is preliminary and is subject to change. 

Gets confidence score information that expresses how confident the speech recognizer is that this is the 
correct token. 

Definition 

Visual Basic Public ReadOnly Property Confidence As Confidence 
C# public Confidence Confidence { get; } 

Managed C++ public: property Confidence get_Confidence(); 

JScript public function get Confidence() : Confidence 

Property Value 

System.Speech.Recognition.Confidence. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

PronunciationString Property 

Note: This documentation is preliminary and is subject to change. 

Gets the pronunciation of the token in string form. 

Definition 

Visual Basic Public ReadOnly Property PronunciationString As String 
C# public string PronunciationString { get; } 

Managed C++ public: property String * getJPronunciationStringO; 

JScript public function get PronunciationString() : String 

Property Value 

System-String. 

This property is read-only. 
Remarks 

String could also be returned in SAPI phone ids. In addition could do a conversion to EPA 
phones for consistency across languages (new feature work). 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerConfidence Property 

Note: This documentation is preliminary and is subject to change. 

Gets confidence score information that expresses how confident the speech recognizer is that this is the 
correct token. 

Definition 

Visual Basic Public ReadOnly Property RecognizerConfidence As Single 
C# public float RecognizerConfidence { get; } 

Managed C++ public: property float get_RecognizerConfidence(); 

JScript public function get RecognizerConfidence() : float 

Property Value 

System.Single. 

This property is read-only. 
Remarks 

This value is not standardized across multiple speech Recognizers and can even change 
from version to version of a specific recognizer. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 

Gets the spoken text of the token. 

Definition 

Visual Basic Public ReadOnly Property Text As String 
C# public string Text { get; } 

Managed C++ public: property String * get_Text(); 

JScript public function get Text() : String 
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Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpokenTokenCollection Class 

Note: This documentation is preliminary and is subject to change. 

Represents a collection of recognized tokens . 

Definition 

. Public Class SpokenTokenCollection 
Visual Basic R ea dOnlyCoUectionBase 

C# public class SpokenTokenCollection : ReadOnlyCoUectionBase 

Managed public gc 

C++ class SpokenTokenCollection : public ReadOnlyCoUectionBase 

JScript public class SpokenTokenCollection extends ReadOnlyCoUectionBase 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



ReadOnlyCoUectionBase 



3 Leave 



SpokenTokenCollection 

Class Information 

Namespace System. Speech.Recognition 
Assembly System. Speech (system.speech.dll) 
Strong System. Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetAlternates Method 
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Note: This documentation is preliminary and is subject to change. 

Gets a collection of alternates specified by a range of tokens in the result. 

Overload List 

public RecognitionPhraseAlternateCollection GetAlternates (Int32, Int32) 
public RecognitionPhraseAlternateCollection GetAlternates (Int32. Int32. Int32) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetAudio Method 

Note: This documentation is preliminary and is subject to change. 

Gets the captured audio that corresponds to the specified range of tokens in this collection. 
Definition 

Public Function GetAudio( _ 
Visual Basic ByVaiyJrsfTbfew As Integer, _ 

ByVal countOfTokens As Integer _ 
) As RecognitionAudio 

public RecognitionAudio GetAudio( 

int first Token. 
? int countOfT okens 

); 

public: RecognitionAudio * GetAudio( 

Managed C++ M f rSt ™%\ 

to int countOfTokens 

); 

public function GetAudio( 
FQ . firstToken : int, 

J^cnpt countOfTokens : tot 

) : Recognition Au dio ; 

Parameters 

firstToken System.Int32. The first token to consider 
countOfTokens System.Int32. The number of tokens to consider 

Return Value 

System.Speech.Recognition.RecognitionAudio. 
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An instance of the RecognitionAudio class that represents the captured audio 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetText Method 

Note: This documentation is preliminary and is subject to change. 
Gets the text that the specified range of tokens represents. 
Definition 

Public Function GetText( _ 

„ ByVal firstToken As Integer . 

Visual Basic ' , / , A % ?- 

By Val countOfT okens As Integer _ 

) As String 

public string GetText( 

mt firstToken , 
int countOfT okens 

); 

public: String * GetText( 

Managed C++ H^'^L\ 

te mt countufi okens 

); 

public function GetText( 
JScriot firstToken : int, 

F countOfT okens : int 
) : String; 

Parameters 

firstToken System.Int32. The first token to consider 
countOfTokens System.Int32. The number of tokens to consider 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Audio Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the captured audio that corresponds to this collection of recognized tokens. 
Definition 

Visual Basic Public ReadOnly Property Audio As RecognitionAudio 
C# public RecognitionAudio Audio { get; } 

Managed C++ public: property Reco gnitionAudio * get AudioO; 

JScript public function get AudioQ • RecognitionAudio 

Property Value 

System.Speech.Recognition.RecognitionAudio. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 



Note: This documentation is preliminary and is subject to change. 

Gets the token at the specified position. 

Definition 

Public ReadOnly Property Item( _ 
Visual Basic ByVal index As Integ er _ 
) As SpokenToken 

public S pokenToken this[ 
C# int index 

] { get; } 

public: property SpokenToken * get_Jtem( 

Managed C++ int index 

); 

JScript In JScript, you can use indexed properties, but you cannot define your own. 

Property Value 

System.Speech.Recognition.SpokenToken. 

This property is read-only. 
Parameters 

index System.Int32. 



//r^.\^rrKTnr»^7-c\T"PA/TD\^v,"PiH a Q "htm 



2/3/04 



Interacting with the Computer using Speech Input ana Speech Output 



Page 157 of 357 



© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 
Gets the text that this collection of token represents. 
Definition 

Visual Basic Public ReadOnly Property Text As Strin g 
C# public string Text { get; } 

Managed C++ public: property String * get_Text(); 

JScript public function get TextQ : String 

Property Value 

System.String. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SystemRecognizer Class 



Note: This documentation is preliminary and is subject to change. 



Represents the shared recognizer. 



Definition 



Public Class SystemRecognizer 
Visual Basic Inherits Object 

Implements IDisposable . IRecognizer 

£g public class SystemRecognizer : Object . 
IDisposable , IRecognizer 

Mana ed C++ P u ^ c § c c * ass SystemRecognizer : public Object . 

* IDisposable , IRecognizer 

to • f public class SystemRecognizer extends Object 
^ implements IRecognizer , IDisposable 



Members Table 
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Inheritance Hierarchy 



Object 



3 Leave 



SystemRecognizer 

Examples 

The following code example creates a SystemRecognizer object and adds delegates to 
events. 

private void SpeechRecognition_Load (obj ect sender, EventArgs e) { // 

Class Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AdaptLanguageModel Method 

Note: This documentation is preliminary and is subject to change. 

Passes a specified string to the recognition engine for use in adapting the active language models. 

Overload List 

public Void AdaptLanguageModel (String) 
public Void AdaptLanguageModel (String[]) 

public Void AdaptLanguageModel (String, String. AdaptationSettings. AdaptationRelevance) 

public Void AdaptLanguageModel f String 

[]. String. AdaptationSettings, AdaptationRelevance) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 

Note: This documentation is preliminary and is subject to change. 
Releases the unmanaged resources used by the SystemRecognizer class. 
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Definition 

Visual Basic Public Sub DisposeO 
C# public void DisposeO; 
Managed C++ public: void DisposeO; 

JScript public function DisposeO : void; 

© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

EmulateRecognize Method 

Note: This documentation is preliminary and is subject to change. 

Simulates a speech recognition event by assuming that a specified string was spoken by the user. 
Overload List 

public Void EmulateRecognize (String) 

public Void EmulateRecognize (String, CompareOptions) 

public Void EmulateRecognize (String[]) 

public Void EmulateRecognize (String[], CompareOptions) 

Examples 

The following code example emulates the recognition of emulateTextBox. 

private void EmulateButton_Click (object sender, EventArgs e) { if (em 

Private Sub EmulateButton_Click (ByVal sender. As Object, ByVal e As EventArgs) H 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InsertBookmark Method 

Note: This documentation is preliminary and is subject to change. 

Sets a bookmark at a specified stream position, and fires the Bookmark event. 

Definition 

Visual Basic Public Sub InsertBookmark( _ 

ByVal streamTimeToDoBookmark As TimeSp an, _ 
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ByVal tag As Object _ 

) 

public void InsertBookmark( 
^ TimeSpan StreamTimeToDoBookmark, 

object tag 

); 

public: void XnsertBookmark( 

TimeSpan StreamTimeToDoBookmark 
Managed C++ Qbject * tag 

); 

public function InsertBookmark( 

. streamTimeToDoBookmark : TimeSpan , 

P tag : Object 

) : void; 



Parameters 



StreamTimeToDoBookmark System.TimeSpan. 
tag System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InsertBookmarkAhead Method 



Note: This documentation is preliminary and is subject to change. 

Sets a bookmark at a specified amount of time ahead of the current audio position, and fires the 
Bookmark event. 

Definition 



Public Sub InsertBookmarkAhead( _ 

w j m . ^ . ByVal timeAheadToDoBookmark As TimeSpan , 
Visual Basic ByVal tag As Object _ 

) 

public void InsertBookmarkAhead( 
TimeSpan timeAheadToDoBookmark, 
object tag 

); 

public: void InsertBookmarkAhead( 
. , , ^ , , TimeSpan timeAheadToDoBookmark, 
Mana S edC++ Object * ta? 

); 

JScript public function InsertBookmarkAhead( 

timeAheadToDoBookmark : TimeSp an, 
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tag : Object 
) : void : 



Parameters 



timeAheadToDoBookmark System.TimeSpan. 
tag System.Object 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



RequestUpdate Method 



Note: This documentation is preliminary and is subject to change. 

Requests an update as soon as the engine can accept it. The system will fire the Update event once the 
recognizer is ready to receive updates. 

Overload List 

public Void RequestUpdate Q 

public Void RequestUpdate (Object) 

public Void RequestUpdate (TimeSpan, Object) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Note: This documentation is preliminary and is subject to change. 

Requests an update as soon as the engine can accept it. The system will fire the Update event once the 
recognizer is ready to receive updates. 



RequestUpdateAhead Method 



Definition 



Public Sub RequestUpdateAhead( 



Visual Basic 



ByVal timeAheadToDoUpdate As TimeSpan , 



ByVal tag As Object _ 

) 

public void RequestUpdateAhead( 



C# 



TimeSp an timeAheadToDoUpdate, 
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public: void RequestUpdateAhead( 
Jjrill TimeSpan timeAheadToDoUpdate, 
Managed C++ object*^ 

); 

public function RequestUpdateAhead( 
. timeAheadToDoUpdate : TimeSpan , 

P tog : Object 

) : void ; 

Parameters 

timeAheadToDoUpdate System.TimeSpan. 
tag System.Object. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SetState Method 

Note: This documentation is preliminary and is subject to change. 

Sets recognizer state. 

Definition 

Public SubSetState(_ 
Visual Basic ByVal state As RecognizerState _ 

} 

public void SetState( 
C# RecognizerState state 

); 

public: void SetState( 
Managed C++ RecognizerState state 

); 

public function SetState( 
JScript state : RecognizerState 
) : void ; 

Parameters 

state System.Speech.Recognition.RecognizerState. State to set 
Remarks 

Recognizer state is set to one of two values. 
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SPRECOSTATE.SPRST_ACTIVE_ALWAYS Indicates the audio is running regardless of 
the rule state. Even if there are no active rules, audio will still be read and passed to the 
engine. This state can be useful for applications if they want to receive volume level events, 
in order to display a VU-meter or similar. 

SPRST_INACTIVE The engine and audio input are inactive and no audio is being read, 
even if there rules active. The audio device will be closed in this state. Normally an 
application should not set the state to SPRSTJNACTIVE because when using the shared 
engine, recognition will be stopped for all applications, not just this one. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

WaitForUpdate Method 



Note: This documentation is preliminary and is subject to change. 

Raises the Update event, and blocks the recognizer until the Update event handler finishes. 
Definition 

Visual Basic Public Sub WaitForUpdate() 
C# public void WaitForUpdateO; 
Managed C++ public: void WaitForUpdateO; 

JScript public function WaitForUpdateO : void ; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ActiveCategory Property 



Note: This documentation is preliminary and is subject to change. 

Gets and sets the active recognizer category. 

Definition 

Visual Basic Public Property ActiveCategory As Category 

C# public Category ActiveCategory { get; set; } 

public: property Category * getActiveCategoryO; 

Manage public: property void set_ActiveCategory( Category *); 

• f public function get ActiveCategoryO : Categ ory 
cn P public function set ActiveCategory ( Category ) ; 

Property Value 
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System.Speech.Recognition.Category. 

This property is read/write. 

© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

Attributes Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of attributes referenced by the recognizer. 
Definition 

Visual Basic Public ReadOnly Property Attributes As Recognizer Attributes 
C# public RecognizerAttributes Attributes { get; } 

Managed C++ public: property Recognizer Attributes * getAttributesQ; 

JScript public function get Attributes() : RecognizerAttributes 

Property Value 

System.Speech.Recognition.RecognizerAttributes. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContent Property 

Note: This documentation is preliminary and is subject to change. 

Returns the content of the audio stream. 

Definition 

Visual Basic Public ReadOnly Property AudioContent As AudioContent 
C# public AudioContent AudioContent { get; } 

Managed C++ public: property AudioContent get_AudioContent(); 

JScript public function get AudioContent() : AudioContent 

Property Value 
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System.Speech.Recognition.AudioContent 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioPosition Property 

Note: This documentation is preliminary and is subject to change. 
Gets the current read or write position of the stream or device in bytes. 
Definition 

Visual Basic Public ReadOnly Property AudioPosition As TimeSp an 
C# public TimeSpan AudioPosition { get; } 

Managed C++ public: property TimeSp an get_AudioPosition(); 

JScript public function get AudioPosition() : TimeSpan 

Property Value 

System.TimeSpan. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

EnableRejection Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer splits recognitions into those with high confidence 
that raise a Recognition event, and those with low confidence that raise a RejectedRecognition event. 
True by default. If set to false, all recognitions fire a Recognition event. 

Definition 



Visual Basic Public Property EnableRejection As Boolean 
C# public bool EnableRejection { get; set; } 

Managed C++ P ublic: _P r0 P ert y bool get_Enab!eRejectionQ; 

* public: property void set_EnableRejection(booI); 

JScript p U blic function get EnableRejectionQ : boolean 
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public function set EnableRejectionf booIean ); 

Property Value 

System.Boolean. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Grammars Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of grammars referenced by the recognizer. 
Definition 

Visual Basic Public ReadOnly Property Grammars As GrammarColIection 
C# public GrammarColIection Graimmars { get; } 

Managed C++ public: property Gr amm arCoIlection * get_Grammars(); 

JScript public function get Grammars() : GrammarColIection 

Property Value 

System.Speech.Recognition.GrammarColIection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Tenns of use. 

IsActive Property 

Note: This documentation is preliminary and is subject to change. 
Gets or sets a value that specifies whether the recognizer is active. Defaults to true. 
Definition 

Visual Basic Public Property IsActive As Boolean 
C# public bool IsActive { get; set; } 

Managed C++ public: _p rop erty bool getJsActive(); 
filp///rAWTlsmnW.9\TRMPWhhRF.Aq htm 
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JScript 



public: property void setlsActive( bool ); 

public function get IsActive() : boolean 
public function set IsActive( boolean ); 



Property Value 

System.Boolean. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Properties Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of properties referenced by the recognizer. 
Definition 

Visual Basic Public ReadOnly Property Properties As RecognizerProperties 
C# public RecognizerProperties Properties { get; } 

Managed C++ public: property RecognizerProperties * getJPropertiesO; 

JScript public function get PropertiesQ : RecognizerProperties 

Property Value 

System.Speech.Recognition.RecognizerProperties. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognizer Property 

Note: This documentation is preliminary and is subject to change. 
Definition 



Visual Basic Public Shared ReadOnly Property Recognizer As SystemReco g nizer 

C# public static SystemRecognizer Recognizer { get; } 
Managed C++ public: property static SystemRe cognizer* get_Recognizer(); 
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JScript public static function get RecognizerQ : S ystemReco g nizer 
Property Value 

System.Speech.Recognition.SystemRecognizer. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerPosition Property 

Note: This documentation is preliminary and is subject to change. 

Gets the current stream position the engine has recognized to. Stream positions are measured in bytes. 
This value can be used to check the engine's progress using the audio data. 

Definition 

Visual Basic Public ReadOnly Property RecognizerPosition As TimeSpan 
C# public TimeSpan RecognizerPosition { get; } 

Managed C++ public: property TimeSpan get_RecognizerPosition0; 

JScript public function get RecognizerPosition() : TimeSpan 

Property Value 

Sys tem.TimeSpan . 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

State Property 

Note: This documentation is preliminary and is subject to change. 

Gets the current state of the recognizer. 

Definition 

Visual Basic Public ReadOnly Property State As RecognizerState 
C# public RecognizerState State { get; } 
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Managed C++ public: property RecognizerState get_JState(); 

JScript public function get State() : RecognizerState 

Property Value 

System.Speech.Recognition.RecognizerState. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ActiveCategoryChanged Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when the active category is changed. 

Definition 

Visual Public 

Basic Event ActiveCategoryChanged As A ctiveCategoryChangedEventHandler 
£g public event 

ActiveCategoryChangedEventHandler ActiveCategoryChanged; 

M (>-f ed P ublic event ActiveCategoryChanged; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContentChanged Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when the type of signal in the audio input changed. 
Definition 

X7 . ir > . Public 
Visual fc>asic 

Event AudioContentChanged As AudioContentChangedEventHandler 
C# public event AudioContentChangedEventHandler AudioContentChanged; 

M (^ ed Public: event AudioContentChanged; 
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© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

Bookmark Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when a bookmark is reached. 

Definition 

Visual Basic Public Event Bookmark As BookmarkEventHandler 
C# public event BookmarkEventHandler Bookmark; 

Managed C++ public: event Bookmark; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Hypothesis Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is partially recognized. 
Definition 

Visual Basic Public Event Hypothesis As RecognitionEventHandler 
C# public event RecognitionEventHandler Hypothesis; 

Managed C++ public: event Hypothesis; 

JScript In JScript, you can use events, but you cannot define your own. 

Examples 

This example handles the Eecognition event and displays the hypothesized result. 

private void Re cognizer_Hypo the sis (object sender, RecognitionEventArgs . e) { 
Private Sub Recognizer__Hypothesis (ByVal sender As Object, ByVal e As Recognitio 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Note: This documentation is preliminary and is subject to change. 

Occurs when the speech recognition engine encounters interference in the input audio stream preventing 
an optimal speech recognition experience. 

Definition 

Visual Basic Public Event InterferenceDetected As InterferenceEventHandler 
C# public event InterferenceEventHandler InterferenceDetected; 

Managed C++ public: event InterferenceDetected; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

NoRecognition Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when a spoken phrase is not recognized. 

Definition 

Visual Basic Public Event NoRecognition As RecognitionEventHandler 
C# public event Recogn itionEventHandler NoRecognition; 

Managed C++ public: event NoRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognition Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is successfully recognized. 
Definition 

Visual Basic Public Event Recognition As RecognitionEventHandler 
filfiV/CAWTNnnWSXTRMPWhhFP.AQ.hlTn 
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C# public event RecognitionEventHandler Recognition; 

Managed C++ public: event Recognition; 

JScript In JScript, you can use events, but you cannot define your own. 

Examples 

This example displays the recognition result and updates the semantics and alternates. 

private void Recognizer_Recognition (obj ect sender, RecognitionEventArgs e 

This sample handles the recognition event. 

Private Sub Recognizer_Recognition (ByVal sender As Object, ByVal e As Reco 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeProgressChanged Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when the input audio volume level changes. 
Definition 

Visual Public 

Basic Event RecognizeProgressChanged As RecognizeProgressChangedEventHandler 
public event 

RecognizeProgressChangedEventHandler RecognizeProgressChanged; 

M £L^+ eC * Public: event RecognizeProgressChanged; 

JScript In JScript, you can use events, but you cannot define your own. 

Examples 

This example updates the audio level meter when the recognition progress has been 
updated. 

private void Recognizer_RecognizeProgressChanged (object sender, Recognize 
Private Sub Recognizer_RecognizeProgressChanged (ByVal sender As Object, 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerStateChanged Event 
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Note: This documentation is preliminary and is subject to change. 

Occurs when recognition starts, or stops; or when recognition is canceled, paused, or resumed. 
Definition 

Visual Public 

Basic Event RecognizerStateChanged As RecognizerStateChangedEventHandler 

r „ public event 

RecognizerStateChangedEventHandler RecognizerStateChanged; 

Managed public: event RecognizerStateChanged; 

C++ 

JScript In JScript, you can use events, but you cannot define your own. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RejectedRecognition Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is recognized with low confidence. 
Definition 

Visual Basic Public Event RejectedRecognition As RecognitionEventHandler 
C# public event RecognitionEventHandler Rej ectedRecognition ; 

Managed C++ public: event RejectedRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Update Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when the RequestUpdate and related methods are used to request that the recognition engine 
pause to allow changes to grammars or other changes to be made. 

Definition 

Visual Basic Public Event Update As UpdateEventHandler 



A^7TXTnnW.Q\TT7A/n>\^lifiT7T7 A Q htm 



Interacting with the Computer using Speech Input and Speech Output 



Page 174 of 357 



C# public event U pdateEventHandler Update; 

Managed C++ public: event Update; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

UpdateEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

Provides data for the Update event. 

Definition 

Visual Basic ^ u ^^ c Class UpdateEventArgs 

Inherits SpeechEv entAr gs 

C# public class UpdateEventArgs : SpeechEventArgs 

Managed C++ public gc class UpdateEventArgs : public SpeechEventArgs 

JScript public class UpdateEventArgs extends SpeechEventArg s 

Members Table 
Inheritance Hierarchy 



Object 



fx] Leave 



EventArgs 



fx] Leave 



S peechEventArg s 

UpdateEventArgs 



Class Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

UpdateEventArgs Method 
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Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the UpdateEventArgs class. 
Definition 

Public Sub UpdateEventArgs( _ 

v i n ■ ByVal audioPosition As TimeSpan , _ 
/isuai Basic ByVaJ fag Ag Qbject _ 

) 

public UpdateEventArgs( 
. g£ TimeSpan audioPosition, 

f object tag 

); 

public: UpdateEventArgs( 

Managed C++ HB^m audioPosition, 
Managed C++ object*^ 

); 

public function UpdateEventArgs( 
„ . audioPosition : TimeSpan . 

cn P tag : Object 

); 

Parameters 

audioPosition System.TimeSpan. Placeholder 

tag System.Object Application supplied object reference. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Tag Property 

Note: This documentation is preliminary and is subject to change. 

Gets an application-supplied object reference. 

Definition 

Visual Basic Public ReadOnly Property Tag As Obj ect 
C# public object Tag { get; } 

Managed C++ public: property Object * getJTagO; 

JScript public function get Tag() : Object 

Property Value 
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System.Object. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IRecognizer Interface 



Note: This documentation is preliminary and is subject to change. 
Provides an interface representing a speech recognizer. 
Definition 

Visual Basic Public Interface IRecognizer 
C# public interface IRecognizer 

Managed C++ public gc interface IRecognizer 

JScript public interface IRecognizer 

Members Table 
Interface Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AdaptLanguageModel Method 

Note: This documentation is preliminary and is subject to change. 

Passes a specified string to the recognition engine for use in adapting the active language models. 

Overload List 

public Void AdaptLanguageModel (String) 
public Void AdaptLanguageModel (String []) 

public Void AdaptLanguageModel (String. String. AdaptationSettings, AdaptationRelevance) 
public Void AdaptLanguageModel (Strin g 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

EmulateRecognize Method 

Note: This documentation is preliminary and is subject to change. 

Simulates a speech recognition event by assuming that a specified string was spoken by the user. 
Overload List 

public Void EmulateRecognize (Strin g) 

public Void EmulateRecognize (String, CompareOptions) 

public Void EmulateRecognize (String [ ]) 

public Void EmulateRecognize (StrmgLL CompareOptions) 

Remarks 

Synchronous recognition emulation. The appropriate events are still raise. 
Synchronous recognition emulation. The appropriate events are still raise. 
Synchronous recognition emulation. The appropriate events are still raise. 
Synchronous recognition emulation. The appropriate events are still raise. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InsertBookmark Method 



Note: This documentation is preliminary and is subject to change. 

Sets a bookmark at a specified stream position, and fires the Bookmark event. 

Definition 

Public Sub XnsertBookmark( _ 

. ByVal streamTimeToDoBookmark As TimeSpan , _ 
Visual Basic ByVal (ag Ag Qbject _ 

) 

public void InsertBookmark( 
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TimeSp an stream TimeToDoBookmark, 
C# object tag 

); 

public: void InsertBookmark( 

, TimeSpan StreamTimeToDoBookmark, 

Managed C++ Qh] J , taq 

); 

public function InsertBookmark( 
. streamTimeToDoBookmark : TimeSpan , 

p tag : Object 

) : void ; 



Parameters 



StreamTimeToDoBookmark System.TimeSpan. 
tag System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

InsertBookmarkAhead Method 



Note: This documentation is preliminary and is subject to change. 

Sets a bookmark at a specified amount of time ahead of the current audio position, and fires the 
Bookmark event. 

Definition . 

Public Sub InsertBookmarkAhead( _ 

. ByVal timeAheadToDoBookmark As TimeSp an, _ 
Visual Basic By Va l tag As Olyect _ 

) 

public void InsertBookmarkAhead( 
TimeSpan timeAheadToDoBookmark, 
4 object tag 

); 

public: void InsertBookmarkAhead( 
Ar ., TimeSpan timeAheadToDoBookmark, 
Managed C++ object* tag 

); 

public function InsertBookmarkAhead( 

YO . A timeAheadToDoBookmark : TimeSpan , 
3Scn # tag : Object 
) : void ; 
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Parameters 



timeAheadToDoBookmark System.TimeSpan. 
tag System.Object. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RequestUpdate Method 

Note: This documentation is preliminary and is subject to change. 

Requests an update as soon as the engine can accept it. The system will fire the Update event once the 
recognizer is ready to receive updates. 

Overload List 

public Void RequestUpdate 0 

public Void RequestUpdate (Object) 

public Void RequestUpdate (TimeSpan, Object) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RequestUpdateAhead Method 



Note: This documentation is preliminary and is subject to change. 

Requests an update when the engine reaches a position a specified amount of time ahead of the current 
audio position. If the time ahead is zero, then the engine pauses as soon as it recognizes speech up to the 
current audio position. 

Definition 

Public Sub RequestUpdateAhead( _ 

. ByVal timeAheadToDoUpdate As TimeSpan , _ 
Visual Basic ByVa] fag Ag Qbject 

) 

public void RequestUpdateAhead( 
. TimeSp an timeAheadToDoUpdate, 
h object tag 

); 

Managed C++ public: void RequestUpdateAhead( 
TimeSpan timeAheadToDoUpdate, 
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JScript 



Object* tag 

); 

public function RequestUpdateAhead( 

timeAheadToDoUpdate : TimeSp an, 
tag : Object 
) : void ; 



Parameters 



— y t j System.TimeSpan. ahead of current audio position that the 
timeAheadToDoUpdate ^ ^ ^ before ^ g ±e update . 

System.Object. Object that will be passed to the delegate when 
called. This can be a reference to any object in the application. 



tag 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

WaitForUpdate Method 

Note: This documentation is preliminary and is subject to change. 

Raises the Update event, and blocks the recognizer until the Update event handler finishes. 
Definition 

Visual Basic Public Sub WaitForUpdateO 
C# public void WaitForUpdateO; 
Managed C++ public: void WaitForUpdateO; 

JScript public function WaitForUpdateO : void ; 

Remarks 

This method will block until the engine is ready to be updated. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Attributes Property 

Note: This documentation is preliminary and is subject to change. 
Gets the recognizer attributes of the underlying recognizer. Read only. 
Definition 
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Visual Basic Public Readonly Property Attributes As Recognizer Attributes 
C# public Recognizer Attributes Attributes { get; } 

Managed C++ public: property RecognizerAttributes * get AttributesO; 

JScript public function get AttributesQ : RecognizerAttributes 

Property Value 

System.Speech.Recognition.Recognizer Attributes. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

AudioContent Property 

Note: This documentation is preliminary and is subject to change. 

Returns the content of the audio stream. 

Definition 

Visual Basic Public ReadOnly Property AudioContent As AudioContent 
C# public AudioContent AudioContent { get; } 

Managed C++ public: property AudioContent get_AudioContent(); 

JScript public function get AudioContentO • AudioContent 

Property Value 

System.Speech.Recognition.AudioContent. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

EnableRejection Property 

Note: This documentation is preliminary and is subject to change. 

Gets a value that specifies whether the recognizer splits recognitions into those with high confidence 
that raise a Recognition event, and those with low confidence that raise a RejectedRecognition event. 
True by default. If set to false, all recognitions fire a Recognition event. 
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Definition 

Visual Basic Public Property EnableRejection As Boolean 

C# public bool EnableRejection { get; set; } 

M , r public: property boot get_EnableRejection(); 

anage public: property void set EnableRejection(bool); 

K . public function get EnableRejectionO • boolean 
cn P public function set EnableRejection( boolean) ; 

Property Value 

System.Boolean. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Grammars Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of grammars attached to this recognizer. 
Definition 

Visual Basic Public ReadOnly Property Grammars As GrammarCollection 
C# public GrammarCollection Grammars { get; } 

Managed C++ public: property GrammarCollection * get_Grammars(); 

JScript public function get GrammarsO : GrammarCollection 

Property Value 

System.Speech.Recognition.Gr ammarColIection . 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IsActive Property 



Note: This documentation is preliminary and is subject to change. 
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Gets or sets a value that specifies whether the recognizer is active. Defaults to true. 



Definition 



Visual Basic Public Property IsActive As Boolean 
C# public bool IsActive { get; set; } 

Managed C++ P ubUc: _P ro P ert y bool get JsActive(); 

8 public: property void set lsActive (bool ) ; 

to • t public function get IsActiveQ : boolean 
crip public function set IsActive(boolean); 



Property Value 

System.Boolean. 



This property is read/write. 



Remarks 



For a top level rule to be recognized, it must be active, it must be housed in an active 
grammar, and that grammar must be housed in a recognizer that is active. If any one of 
these three conditions are not met, the rule cannot be recognized. Setting this method is 
used in the shared case to activate and deactivate a set of grammars simultaneously. 



© 2003 Microsoft Corporation: All rights reserved. Terms of use. 

Properties Property 

Note: This documentation is preliminary and is subject to change. 
Gets the properties of this instance of the recognizer. 



Definition 



Visual Basic Public ReadOnly Property Properties As RecognizerProperties 
C# public RecognizerProperties Properties { get; } 

Managed C++ public: property RecognizerProperties * get_Properties(); 

JScript public function get Properties() : RecognizerProperties 

Property Value 

System.Speech.Recognition.RecognizerProperties. 

This property is read-only. 
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Remarks 



Take care when setting the properties when using the Shared Recognizer as these values 
affect all running Speech applications that are also using the Shared Recognizer. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

State Property 

Note: This documentation is preliminary and is subject to change. 

Gets the current state of the recognizer. 

Definition 

Visual Basic Public ReadOnly Property State As Reco gnizerState 
C# public RecognizerState State { get; } 

Managed C++ public: property RecognizerState get_State(); 

JScript public function get StateO : RecognizerState 

Property Value 

System.Speech.Recognition.RecognizerState. 

This property is read-only. 
Remarks 

State cannot be set directly. Use the Recognize0, RecognizeAsync(), StopRecognize(), 
Pause(), or Resume() methods instead. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContentChanged Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when the type of signal in the audio input changed. 
Definition 

Afie«oi T^ficip Pnbl c 

Event AudioContentChanged As AudioContentChangedEventHandler 
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C# public event AudioContentChangedEventHandler AudioContentChanged; 
Managed public: _ event AudioContentChanged; 

C++ 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

Applications may handle this event to provide user feedback that speech recognition is 
occurring. This event encompasses the SALT SpeechDetected event and multiple audio 
state related events from SAPI (StreamStart, SoundStart, PhraseStart, SoundEnd, 
StreamEnd). 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Bookmark Event 



Note: This documentation is preliminary and is subject to change. 

Occurs when a bookmark is reached. 

Definition 

Visual Basic Public Event Bookmark As BoohnarkEventHandler 
C# public event BoohnarkEventHandler Bookmark; 

Managed C++ public: event Bookmark; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Hypothesis Event 



Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is partially recognized. 
Definition 

Visual Basic Public Event Hypothesis As RecognitionEventHandler 
C# public event RecognitionEventHandler Hypothesis; 

Managed C++ public: event Hypothesis; 

JScript In JScript, you can use events, but you cannot define your own. 
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Remarks 

The application may use this event to display intermediate recognition results to the user. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InterfereneeDetected Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when the speech recognition engine encounters interference in the input audio stream preventing 
an optimal speech recognition experience. 

Definition 

Visual Basic Public Event InterfereneeDetected As InterferenceEventHandler 
C# public event InterferenceEventHandler InterfereneeDetected; 

Managed C++ public: event InterfereneeDetected; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

The application may handle this event to provide feedback to the user to correct the 
interference. Use the InterferenceEventArg parameter to access the interference type . 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

NoRecognition Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when a spoken phrase is not recognized. 

Definition 

Visual Basic Public Event NoRecognition As RecognitionEventHandler 
C# public event RecognitionEventHandler NoRecognition; 

Managed C++ public: event NoRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 



^i*. un .\^rrxmnwc\TT7A/fP\_ViV.T7P A Q htm 



9./V04 



Interacting with the Computer using Speech Input and Speech Output Page 1 87 of 357 



Use this event to indicate to the user that the spoken phrase was unrecognized. The Result 
object in the event args will be null. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Recognition Event 



Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is successfully recognized. 
Definition 

Visual Basic Public Event Recognition As RecognitionEventHandler 
C# public event RecognitionEventHandler Recognition; 

Managed C++ public: event Recognition; 

JScript In JScript, you can use events, but you cannot define your own. 



Remarks 



Use the RecognitionEventArgs parameter to return the audio position and recognition 
result. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeProgressChanged Event 

Note: This documentation is preliminary and is subject to change. 
Occurs when the input audio volume level changes. 
Definition 

Visual Public 

Basic Event RecognizeProgressChanged As RecognizeProgressChangedEventHandler 
„ public event 

RecognizeProgressChangedEventHandler RecognizeProgressChanged; 

^C++ P u ^^ c: event RecognizeProgressChanged; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 
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This event can be used to dynamically update a VU (volume unit) meter for user feedback 
without implementing logic to update the VU meter every fixed interval. Use the 
Recognizer. AudioLevel property to get current audio volume level. 

Consider limiting the event so it is raised no more than 10 times per second. Furthermore, 
no additional RecognizeProgressChanged event is raised until the detect 
Recognizer.get_AudioLevel event is been processed. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerStateChanged Event 



Note: This documentation is preliminary and is subject to change. 

Occurs when recognition starts, or stops; or when recognition is canceled, paused, or resumed. 
Definition 

Visjial Public 

Basic Event RecognizerStateChanged As RecognizerStateChangedEventHandler 

ru public event 

RecognizerStateChangedEventHandler RecognizerStateChanged; 

M ^*| ed public: _event RecognizerStateChanged; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RejectedRecognition Event 



Note: This documentation is preliminary and is subject to change. 
Occurs when a spoken phrase is recognized with low confidence. 
Definition 

Visual Basic Public Event RejectedRecognition As RecognitionEventHandler 
C# public event RecognitionEventHandler RejectedRecognition; 

Managed C++ public: event RejectedRecognition; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 
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The application should confirm the recognition result with the user before processing this 
event as a successful recognition. Use the RecognitionEventArgs parameter to return the 
audio position and recognition result. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Update Event 



Note: This documentation is preliminary and is subject to change. 

Occurs when the RequestUpdate and related methods are used to request that the recognition engine 
pause to allow changes to grammars or other changes to be made. 

Definition 

Visual Basic Public Event Update As UpdateEventHandler 
C# public event UpdateEventHandler Update; 

Managed C++ public: event Update; 

JScript In JScript, you can use events, but you cannot define your own. 

Remarks 

The Update event is raised to allow the application to make the necessary changes. After the 
application returns from the event the recognition engine resumes processing. While the 
event is being raised recognition will not occur, but input audio will continue to be collected 
and stored by the recognizer in an audio buffer. After the application returns from the event 
the buffered audio data will be processed ensuring that no real-time audio data is lost and 
that the user experience is not interrupted. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AdaptationRelevance Enumeration 



Note: This documentation is preliminary and is subject to change. 
Specifies an estimate of the language model data relevance. 
Definition 

Visual Basic Public Enum AdaptationRelevance 
C# public enum AdaptationRelevance 

Managed C++ value public enum AdaptationRelevance 

JScript public enum AdaptationRelevance 
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Constants 



Constant 
Name 

Unknown 
Low 
Medium 



Description 

The application has no information on relevance. Probably the same as Low 
relevance, but specified separately. 

Language model data relevance is low. Text data might be arbitrary 
documents, and not be representative of the user or topic. 
Language model data relevance is medium. Text data has additional 
relevance, documents are previously written by user. 
„. , Language model data relevance is high. Data is directly selected by the user 

g or application for this topic. 

Enumeration Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AdaptationSettings Enumeration 

Note: This documentation is preliminary and is subject to change. 

Specifies the options to use with the AdaptLanguageModel method to control the language model 
adaptation process. 

Definition 

Visual Basic Public Enum AdaptationSettings 
C# public enum AdaptationSettings 

Managed C++ value public enum AdaptationSettings 

JScript public enum AdaptationSettings 

Constants 

Constant Name Description 

Default Default engine settings. 

A p . Perform adaptation for this recognizer object only, and do not 

AdaptUirrentKecogmzer gtore ±q q{ ^ adaptation after the recogn i Z er is closed. 



Persistently store the result of the adaptation in the RecoProfile. 
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. rs r-, This flag can be combined with the AdaptCurrentRecognizer 
AdaptRecognizerProfile ^ a 

Immediately store the result of the adaptation. Sometimes 
Immediate engines will wait until a certain amount of data is obtained before 

adapting. This makes the adaptation occur immediately. 

Enumeration Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContent Enumeration 

Note: This documentation is preliminary and is subject to change. 

Specifies the current audio state. 

Definition 

Visual Basic Public Enum AudioContent 
C# public enum AudioContent 

Managed C++ value public enum AudioContent 

JScript public enum AudioContent 

Constants 



Description 



Constant 
Name 

Stopped The audio input is stopped. 

Silence The audio input contains silence. 

Sound ^ e auc ^° i n P ut contains a non-silence signal, but is not identifiable as 

Dwt speech. 

Speech The audio input contains a speech signal. 

Enumeration Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Confidence Enumeration 

Note: This documentation is preliminary and is subject to change. 

Specifies the various high level confidence values possible for speech recognition. 

Definition 

Visual Basic Public Enum Confidence 
C# public enum Confidence 

Managed C++ value public enum Confidence 

JScript public enum Confidence 



Constants 



Constant 
Name 



Description 



Normal 



Indicates that the speech recognizer has high confidence that the audio was 
„. , processed correctly. When an application discovers that something has a high 

lg level of confidence, it's very likely that the user did in fact say what was 

recognized. 

Indicates that the speech recognizer has a normal level of confidence that the 
audio was processed correctly. 
Indicates that the speech recognizer has a low level of confidence that the 
Low audio was processed correctly. This means that it is likely that that the 

recognition result is not what the user actually said. 

Enumeration Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6. 0.4044.0, Culture==neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InterferenceType Enumeration 
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Note: This documentation is preliminary and is subject to change. 

Specifies the types of interference in the audio input preventing an optimal speech recognition 
experience. 

Definition 

Visual Basic Public Enum InterferenceType 
C# public enum InterferenceType 

Managed C++ value public enum InterferenceType 

JScript public enum InterferenceType 

Constants 

C « nstant Description 
Name 

TooNoisy The audio input is too noisy for accurate recognition of the input phrase. 
NoSignal The audio input does not contain any audio signal (flat line). 

The audio input is too loud for optimal recognition, resulting in clipping of 
the signal. 

The audio input is too soft, resulting in sub-optimal recognition of the 
input phrase. 

TooFast The audio input is too fast for optimal recognition. 

TooSlow The audio input is too slow for optimal recognition. 

Enumeration Information 

Namespace System. Speech.Recognition 

Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 1 43bb27e7ac8b 



TooLoud 
TooSoft 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

LeadingSpace Enumeration 

Note: This documentation is preliminary and is subject to change. 

Specifies how to handle leading space when incorporating RecognitionResult text into surrounding text. 
Definition 

Visual Basic Public Enum LeadingSpace 
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C# public enum LeadingSpace 

Managed C++ value public enum LeadingSpace 

JScript public enum LeadingSpace 



Constants 



Constant Name Description 

Indicates that the application will consume spaces before the 
ConsumeLeadingSpaces RecognitionResult that is being incorporated into surrounding 

text. 

Indicates that the application will not insert additional space 
before the RecognitionResult that is being incorporated into 
surrounding text. 

Indicates that the application will inject a single additional space 
before the RecognitionResult. 

Indicates that the application will inject two additional spaces 
before the RecognitionResult. 



NoLeadingSpaces 

OneLeadingSpace 
TwoLeadingSpaces 



Enumeration Information 



Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeMode Enumeration 



Note: This documentation is preliminary and is subject to change. 
Specifies the recognition mode. 



Definition 



Visual Basic Public Enum RecognizeMode 
C# public enum RecognizeMode 

Managed C++ value public enum RecognizeMode 

JScript public enum RecognizeMode 

Constants 



Constant Name Description 
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Automatic The recognition mode'is automatic. 
Multiple The recognition mode is multiple. 

Enumeration Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerState Enumeration 

Note: This documentation is preliminary and is subject to change. 

Specifies the current state of the recognizer. 

Definition 

Visual Basic Public Enum RecognizerState 
C# public enum RecognizerState 

Managed C++ value public enum RecognizerState 

JScript public enum RecognizerState 



Constants 



Description 



Constant 
Name 

Stopped The recognizer is currently stopped, and is not listening. 

The recognizer is currently paused, with input audio continuing to be 
queued. 

Listening The recognizer is currently listening. 

The recognizer is currently asleep. It will wake up if the user says "Wake 
up" 



Paused 



Sleeping 
Enumeration Information 



Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture^neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ResultType Enumeration 



Note: This documentation is preliminary and is subject to change. 
Specifies the types of recognition result that can be sent. 
Definition 

Visual Basic Public Enum ResultType 
C# public enum ResultType 
Managed C++ value public enum ResultType 
JScript public enum ResultType 

Constants 

Constant Name Description 

A trecoignition result which is a hypothesis, or a 
Hypothesis provisional match of part of the input speech. 

_ A recognition result that the engine recommends can be 

Recognition 

A recognition result that has low confidence and thus the 
RejectedRecognition engine does not recommend acting on without 

confirmation from the user. 

XT _ . . The recognizer finished processing the speech but was 

NoRecognition ^ recQgnize my ^ g 

/~\ja t% • The engine recognized speech for a different application, 
RecogmtionForOtherRecogmzer ^ ^ m ^ wag ^ ^ 

■ . . Recognition terminated due to initial silence or babble 

RecognitionTimeout . . . 

& timeout. 

Examples 

The following code example displays the recognition result and updates the semantics and 
alternates. 

private void Recognizer_Recognition (object sender, RecognitionEventArgs e 
Private Sub ProcessRecognition (ByVal e As RecognitionEventArgs) 1 D 

Enumeration Information 

Namespace System.Speech.Recognition 
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Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TrailingSpace Enumeration 



Note: This documentation is preliminary and is subject to change. 

Specifies how to handle trailing space when incorporating the RecognitionResult's text into surrounding 
text. 

Definition 



Visual Basic Public Enum TrailingSpace 
C# public enum TrailingSpace 

Managed C++ value public enum TrailingSpace 

JScript public enum TrailingSpace 

Constants 

Constant Name Description 

Indicates that the application will consume spaces after the 
ConsumeTrailingSpaces RecognitionResult that is being incorporated into surrounding 

text. 

Indicates that the application will not inject any additional spaces 
NoTrailingSpaces after the RecognitionResult that is being incorporated into 

surrounding text. 

Indicates that the application will inject a single additional space 
OneTrailingSpace after the RecognitionResult that is being incorporated into 

surrounding text. 

Indicates that the application will inject two additional spaces 
TwoTrailingSpaces after the RecognitionResult that is being incorporated into 

surrounding text. 

Enumeration Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DictationTopic Structure 

Note: This documentation is preliminary and is subject to change. 

Represents a dictation topic. 

Definition 

Visual Basic Public Structure DictationTopic 
C# public struct DictationTopic 

Managed C++ public value struct DictationTopic 

JScript In JScript, you can use structures, but you cannot define your own. 

Members Table 
Remarks 

Standard topics (general, spelling) are predefined, others can be created. 

Structure Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DictationTopic Method 

Note: This documentation is preliminary and is subject to change. 
Create a new dictation topic from a topic name. 
Definition 

Public Sub DictationTopic( _ 
Visual Basic ByVal topicName As String 

) 

q# public DictationTopic( 
string topicName 
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); 

public: DictationTopic( 
Managed C++ String* topicName 

); 

public function DictationTopic( 
JScript topicName : String 

); 

Parameters 

topicName System.String. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Equals Method 



Note: This documentation is preliminary and is subject to change. 

Gets a value indicating whether the tag formats represent the same string. 

Overload List 

public override Boolean Equals f Object) 
public override Boolean Equals (DictationTopic) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetHashCode Method 



Note: This documentation is preliminary and is subject to change. 

Gets the hash code of the tag format string. 

Definition 

Visual Basic Overrides Public Function GetHashCode() As Integer 

C# public override tat GetHashCodeO; 
Managed C++ public: tat GetHashCodeO; 

JScript public override function GetHashCodeO " tat ; 

Return Value 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 

Note: This documentation is preliminary and is subject to change. 

Gets a string representation of the topic name. 

Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System.String. 

String representation 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

General Property 

Note: This documentation is preliminary and is subject to change. 

Gets a general dictation topic. 

Definition 

Visual Basic Public Shared ReadOnly Property General As DictationTopic 
C# public static DictationTop ic General { get; } 

Managed C++ public: property static DictationTop ic get_General0; 

JScript public static function get GeneralO : DictationTopic 

Property Value 

System.Speech.Recognition.DictationTopic. 
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This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Spelling Property 

Note: This documentation is preliminary and is subject to change. 

Gets a spelling topic. 

Definition 

Visual Basic Public Shared ReadOnly Property Spelling As DictationTopic 
C# public static DictationTopic Spelling { get; } 

Managed C++ public: property static DictationTop ic get_Spelling(); 

JScript public static function get SpellingO : DictationTopic 

Property Value 

System.Speech.Recognition.DictationTopic. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ActiveCategoryChangedEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 

Represents the method that will handle the ActiveCategoryChangedEventHandler event. 

Definition 

Public Delegate Sub ActiveCategoryChangedEventHandler( _ 
« . ByVal sender As Object , _ 
Visual Basic ByVa} g As ActiveCate g ory changedEventArg s _ 

) 

public delegate void ActiveCategoryChangedEventHandler( 
„ object sender, 

ActiveCategoryChangedEventArgs e 

); 

public: gc delegate void ActiveCategoryChangedEventHandler( 

Object * sender, 
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r> , ■ ActiveCate goryChan gedEventAr gs* e 
Managed C++ y to 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.ActiveCategoryChangedEventArgs. 

Delegate Information 

Namespace System.Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioContentChangedEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 
Represents the method that will handle the AudioContentChanged event. 
Definition 

Public Delegate Sub AudioContentChangedEventHandler( _ 

Visual Basic ByVal Wer As Object, _ 

visual uasic ByVal e As AudioContentChangedEventArgs _ 

) 

public delegate void AudioContentChangedEventHandler( 
r „ object sender, 

AudioContentChangedEventArgs e 

); 

public: gc delegate void AudioContentChangedEventHandler( 

^ , r , Object * sender, 

Managed C++ AudioContentChangedEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.AudioContentChangedEventArgs. 
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Delegate Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkEventHandler Delegate 



Note: This documentation is preliminary and is subject to change. 
Represents the method that will handle the Bookmark event. 
Definition 

Public Delegate Sub BookmarkEventHandler( _ 

Visual Basic ByVal Wer As Object, _ 

visual uasic ByVaJ g Ag BookmarkEvent Arg s _ 

) 

pubhc delegate void BookmarkEventHandler( 
r „ object sender, 

BookmarkEventArgs e 

); 

public: gc delegate void BookmarkEventHandler( 

„ j . , Object * sender, 
Managed C++ BookmarkEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.BookmarkEventArgs. 

Delegate Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 
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CommandRecognitionEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 

Represents the method that will handle the CommandRecognition event in Command and CommandSet. 
Definition 

Public Delegate Sub CommandRecognitionEventHandler( _ 
. i R • ByVal sender As Object, _ 
Visual Basic ByVal g Ag CommandR e C oanitionEventAros _ 

) 

public delegate void CommandRecognitionEventHandler( 
r „ object sender, 

CommandRecognitionEventArgs e 

); 

public: gc delegate void CommandRecognitionEventHandler( 

r Object * sender, 
Managed C++ CommandRec ognitionEventArgs* e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.CommandRecognitionEventArgs. 

Delegate Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 1 43bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

InterferenceEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 
Represents the method that will handle the InterferenceDetected event. 
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Definition 



Public Delegate Sub InterferenceEventHandler( _ 

Visual Basic ByVal sender As Qhm > " 

v isuai isasic ByVal e Ag Tnter f erence EventArgs _ 

) 

public delegate void InterferenceEventHandler( 
object sender, 
^ InterferenceEventArg s e 

); 

public: gc delegate void InterferenceEventHandler( 

^ . ■ r Object * sender, 
Managea u++ TnterferenceEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.InterferenceEventArgs. 

Delegate Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral 5 

Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognitionEventHandler Delegate 



Note: This documentation is preliminary and is subject to change. 

Represents the method that will handle the following events: Recognition, RejectedRecognition, and 
Hypothesis. 

Definition 

Public Delegate Sub RecognitionEventHandler( 

Visual Basic ByVal sender As Qbj ^ J - 

visual J^asic ByVal e A§ RecQ g nitionEv entArgs _ 

) 

public delegate void RecognitionEventHandler( 

obj ect sender, 
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r » Reco gnitionEventArg s e 

public: gc delegate void RecognitionEventHandler( 

„ A rj . Object * sender, 
Managed C++ Reco gnitionEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System. Object. 

e System.Speech.Recognition.RecognitionEventArgs. 

Delegate Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeCompletedEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 
Represents the method that will handle the RecognizeCompleted event. 
Definition 

Public Delegate Sub RecognizeCompletedEventHandler( _ 
. By Val sender As Object _ 
Visual Basic ByVa] e Ag Rec0 g nize Co m pletedEventArgs _ 

) 

public delegate void RecognizeCompletedEventHandIer( 
u object sender, 

RecognizeCompletedEventArgs e 

); 

public: gc delegate void RecognizeCompletedEventHandler( 

^ , r , Object* sender, 

Managea C++ RecognizeComp i etedEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
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Parameters 

sender System.Object. 

e System.Speech.Recognition.RecognizeCompletedEventArgs. 

Delegate Information 

Namespace Sysfem.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=3 65 1 43bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizeProgressChangedEventHandler 
Delegate 

Note: This documentation is preliminary and is subject to change. 
Represents the method that will handle the RecognizeProgressChanged event. 
Definition 

Public Delegate Sub RecognizeProgressChangedEventHandler( _ 
. ByVal sender As Object , _ 
Visual Basic ByVal e Ag Recognize p r0 g r essChangedEventArg s _ 

) 

public delegate void RecognizeProgressChangedEventHandler( 
£0 object sender, 

RecognizeProgressChangedEventArgs e 

); 

pubhc: gc delegate void RecognizeProgressChangedEventHandler( 

r++ Object * sender, 
anage Reco g nizeProgressChangedEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognitioa.RecognizeProgressChangedEventArgs. 

Delegate Information 
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Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RecognizerStateChangedEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 
Represents the method that will handle the RecognizerStateChanged event. 
Definition 

Public Delegate Sub RecognizerStateChangedEventHandler( _ 
. . . ByVal sender As Object , _ 
Visual Jiasic ByVal g Ag Recognizer stateChangedEventAr gs _ 

) 

public delegate void RecognizerStateChangedEventHandler( 
r „ object sender, 

RecognizerStateChangedEventArg s e 

); 

public: gc delegate void RecognizerStateChangedEventHandler( 

ivr h r+4 Object * sender, 

Managed C++ RecognizerStateChangedEventAr gs* e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.RecognizerStateChangedEventArgs. 

Delegate Information 

Namespace System.Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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SpeechEventHandler Delegate 

Note: This documentation is preliminary and is subject to change. 

Represents the method that will handle the following events: NoRecognition, AudioLevelChanged, 
RecognitionStarted, RecognitionStopped, RecognitionCanceled, RecognitionPaused, and 
RecognitionResumed. 

Definition 

Public Delegate Sub SpeechEventHandler( _ 

_ 7 . . _ . By Val sender As Object 
Visual Basic t> \r i a o ~ur? /T 

ByVal e As SpeechEventArgs _ 

) 

public delegate void SpeechEventHandler( 
^ object sender, 

SpeechEventArgs e 

); 

public: gc delegate void SpeechEventHandler ( 

Man a ed C++ Object* sender, 

8 SpeechEventArg s* e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 



Parameters 



sender System.Object 

e System.Speech.Recognition.SpeechEventArgs. 

Delegate Information 

Namespace System. Speech.Recognition 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 

Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

UpdateEventHandler Delegate 



Note: This documentation is preliminary and is subject to change. 
Represents the methods that handle the Updated event and related events. 
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Definition 

Public Delegate Sub UpdateEventHandler( _ 
. . ByVal sender As Object, _ 

Visual Basic ByVal e Ag TJ p dateEve ptArgs _ 

) 

public delegate void UpdateEventHandler( 
object sender, 
* UpdateEventArgs e 

); 

public: gc delegate void UpdateEventHandler( 

_ _ , , Object * sender, 
Managed C++ TJ pdateEventArgs * e 

); 

JScript In JScript, you can use delegates, but you cannot define your own. 
Parameters 

sender System.Object. 

e System.Speech.Recognition.UpdateEventArgs. 

Delegate Information 

Namespace System. Speech.Recognition 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6. 0.4044.0, Culture==neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

Remarks 

The RequestUpdate and related methods are used to request that the recognition engine 
pause to allow changes to grammars or other changes to be made. When the engine 
responds to the request, the Update event is called to allow the application to make the 
necessary changes. After the application returns from the event die recognition engine 
resumes processing. While the event is being called, recognition will not be occurring, but 
input audio will continue to be collected and stored by the Recognizer in an audio buffer. 
After the application returns from the event the buffered audio data will be processed 
ensuring that no real-time audio data is lost and that the user experience is not interrupted. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

System.Speech.Srgs 



Note: This documentation is preliminary and is subject to change. 
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The following tables list the members exposed by the System.Speech.Srgs namespace. 

Classes 



Example 
Item 

ItemElementCollection 
OneOf 

OneOfElementCollection 
PropertyTa g 

Rule 

RuleCollection 
RuleElementCollection 

RuleRef 

SpecialRuleRef 

SrgsGrammar 
SrgsText 

lag 
Token 



Represents the World Wide Web Consortium (W3C) Speech 
Recognition Grammar Specification (SRGS) example element. 
See http://www.w3.org/TR/speech-grammar/ for more 
information. 

Represents the World Wide Web Corsortium (W3C) Speech 
Recognition Grammar Specification (SRGS) item element. See 
http://www.w3.org/TR/speech-grammar/ for more information. 

Represents the collection of objects that can be children of an 
Item class instance. 

Represents the World Wide Web Consortium (W3C) Speech 
Recognition Grammar Specification (SRGS) one-of element. See 
http://www.w3.org/TR/speech-grammar/ for more information. 

Represents a collection of objects that can be child elements of 
an OneOf class instance. 

Represents the World Wide Web Consortium (W3C) Speech 
Recognition Grammar Specification (SRGS) tag element with 
S API Properties. See http://www.w3.org/TR/speech-granimar/ 
for more information. 

Represents the World Wide Web Consortium (W3C) Speech 
Recognition Grammar Specification (SRGS) rule element. See 
http://www.w3c.org/TR/speech-grammar/ for more information. 

Represents a collection of objects that can be child elements of a 
Rule class instance. 

Represents a collection of objects that are valid within a Rule 
class instance. 

Example represents the World Wide Web Consortium (W3C) 
Speech Recognition Grammar Specification (SRGS) ruleref 
element. See http://www.w3.org/TR/speech-grammar/ for more 
information. 

SpecialRuleRef class instance allow grammars based on context- 
free grammars (CFG) to have powerful additional features, such 
as transitions into dictation (both recognized or not recognized) 
and word seqeuences from SAPI 5.0. 

Represents the logical housing for individual rules and dictation 
grammars. 

Represents text content in Speech Recognition Grammar 
Specification (SRGS) markup. 

Represents the World Wide Web Consortium (W3C) Speech 
Recognition Grammar Specification (SRGS) tag element. See 
http://www.w3.org/TR/speech-grammar/ for more information. 

Token represents the World Wide Web Consortium (W3C) 
Speech Recognition Grammar Specification (SRGS) token 
element. See http://www.w3.org/TR/speech-grammar/ for more 
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information. 

Interfaces 



The IltemElement interface is an empty interface implemented by all Speech 
Recognition Grammar Specification (SRGS) elements that can be a child 
Iltemhlement element of the item element ( Item5 OneOf, RuleRef, SpecialRuleRef, Tag, 

Token, SrgsText) 

The IRuleElement interface is an empty interface implemented by all 
1 fi Speech Recognition Grammar Specification (SRGS) elements that can be a 
IKulehlement child element of the Rule element (Example, Item, OneOf, RuleRef, 

SpecialRuleRef, Tag, Token, SrgsText) 

Enumerations 



GrammarMode 



RuleScope 



Identifies the grammar mode as either Voice or dual tone, multi- 
frequency (DTMF). 

RuleScope specifies how a rule behaves. The behavior includes 
whether or not it can be referenced by other rules and whether or not 
the rule can be activated. 
Special rule references allow grammars based on context-free 
9 • id 1 B fr grammars (CFG) to have powerful additional features, such as 
pecia ue e ype tTansitions j nto dictation (both recognized or not recognized) and 
word sequences from SAPI 5.0. 



Structures 

TagFormat TagFormat extensible enumeration. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Example Class 



Note: This documentation is preliminary and is subject to change. 



Represents the World Wide Web Consortium (W3C) Speech Recognition Grammar Specification 
(SRGS) example element. See http://www.w3.org/TR/speech-grammar/ for more information. . 

Definition 



Public Class Example 
Visual Basic Inherits Object 

Implements IRuleElement 
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public class Example : Object , 
C# lRuleElement 

,^ .public gc class Example : public Object, 
Mana g edC++ TRuliElement 

• t public class Example extends Object 
cn P implements lRuleElement 



Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



Example 

Class Information 

Namespace System. Speech. Srgs 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Example Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the Example class. 
Overload List 

public Example 0 
public Example (String) 

Remarks 

The Example property must be set prior to committing the associated rule(s) to the 
Grammar object. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 
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Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Public Function ToString() As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO • String ; 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 



Note: This documentation is preliminary and is subject to change. 
Gets and sets Example class text. 



Definition 



Visual Basic Public Property Text As String 
C# public string Text { get; set; } 

Manazed C++ pubHc: J"°P ert y String* get_TextO; 

s public: property void set_Text( String *); 

jo • f public function get TextO : String 
P public function set Text( String ); 



Property Value 

System.String. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Class 



Note: This documentation is preliminary and is subject to change. 
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Represents the World Wide Web Corsortium (W3C) Speech Recognition Grammar Specification 
(SRGS) item element. See http://www.w3.org/TR/speech-grammar/ for more information. 

Definition 

Public Class Item 
Visual Basic Inherits Object 

Implements IltemElement . IRuleElement 

public class Item : Object , 
IltemElement IRuleElement 

MflnaopH r++ P^lic _gc class Item : public Object, 
managed 1,-1-1- ntemElement IRuleElement 

to • f public class Item extends Object 

P implements IRuleElement . IltemElement 

Members Table 
Inheritance Hierarchy 



Object 



[x] Leave 



Item 

Class Information 

Namespace System. Speech. Srgs 

Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the Item class. 
Overload List 

public ItemQ 

public Item (String) 

public Item (String, Tag) 

public Item (String. PropertyTag) 
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public Item (String, Tag, Single) 
public Item Qnt32. Int32) 
public Item Ont32, Int32. Single) 
public Item (IltemElement) 

Remarks 

The weight of an Item is the probability that the user will speak the phrase contained in the 
Item, as opposed to another phrase contained in a sibling Item. 

The minRepeat parameter describes the number of occurrences the user must speak the 
phrase contained in this Item class instance for the recognition to be successful. 

The maxRepeat parameter describes the number of occurrences the user can speak the 
phrase contained in this Item class instance and still have a successful recognition. 

The minRepeat parameter describes the number of occurrences the user must speak the 
phrase contained in this Item class instance for the recognition to be successful. 

The maxRepeat parameter describes the number of occurrences the user can speak the 
phrase contained in this Item class instance and still have a successful recognition. 

The repeatProbability parameter describes the probability that the phrase contained in this 
Item class instance will be repeated one or more times. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

SetRepeat Method 



Note: This documentation is preliminary and is subject to change. 
Sets the repeat count for the Item class instance. 
Overload List 

public Void SetRepeat 0x032) 
public Void SetRepeat Qnt32. M32) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Elements Property 



Note: This documentation is preliminary and is subject to change. 
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Gets the zero-based collection of all the child elements of the Item class instance. Read only. 
Definition 

Visual Basic Public ReadOnly Property Elements As ItemElementCollection 
C# public ItemElementCollection Elements { get; } 

Managed C++ public: property ItemElementCollection * get ElementsO; 

JScript public function get ElementsQ : ItemElementCollection 

Property Value 

System.Speech.Srgs.ItemElementCollection. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

MaxRepeat Property 



Note: This documentation is preliminary and is subject to change. 

Gets the maximum number of occurrences this Item class instance can be repeated for a successful 
recognition. Read-only. 

Definition 

Visual Basic Public ReadOnly Property MaxRepeat As Integ er 
C# public int MaxRepeat { get; } 

Managed C++ public: property int get_MaxRepeat(); 

JScript public function get MaxRepeatQ : int 

Property Value 

System.Int32. 

This property is read-only. 
Remarks 

This property represents a portion of the repeat attribute of the World Wide Web 
Consortium (W3C) Speech Recognition Grammar Specification (SRGS) item element. 

See Also 

• MaxRepeat 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

MinRepeat Property 

Note: This documentation is preliminary and is subject to change. 

Gets the minimum number of occurrences this Item class instance must be repeated for a successful . 
recognition. Read-only. 

Definition 

Visual Basic Public Readonly Property MinRepeat As Integer 
C# public int MinRepeat { get; } 

Managed C++ public: property int get MinRepeatO; 

JScript public function get MinRepeatO : int 

Property Value 

System.Int32. 

This property is read-only. 
Remarks 

This property represents a portion of the repeat attribute of the World Wide Web 
Consortium (W3C) Speech Recognition Grammar Specification (SRGS) item element. 

See Also 

• MaxRepeat 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RepeatProbability Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets a value representing the probability that the phrase contained in an Item class instance will 
be repeated. 

Definition 

Visual Basic Public Property RepeatProbability As Sin gle 



r,\<*-//rM\rrKTnnVi7Z\TTiAAV\~hhvv a Qht™ 



Interacting with the Computer using Speech Input and Speech Output Page 219 of 357 

C# public float RepeatProbability { get; set; } 

public: property float getRepeatProb ability (); 

Managed C++ public . _p roperty void set_RepeatProbability(float); 

• f public function get RepeatProbabilityO - float 
Script public fimction set RepeatProbability(float); 

Property Value 

System.Single. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Weight Property 



Note: This documentation is preliminary and is subject to change. 

Gets and sets the likelihood that the phrase contained in an Item class instance will be uttered when 
contained within a OneOf class instance. 

Definition 

Visual Basic Public Property Weight As Single 
C# public float Weight { get; set; } 

Managed C++ public: -J> ro P ert y get_Weight(); 
ivianagea w public . _p roperty void S et^Weight(float); 

• f public function get Weight() : float 
Scnpt public function set Weight(float); 

Property Value 

System.Single. 

This property is read/write. 

. © 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ItemElementCollection Class 



Note: This documentation is preliminary and is subject to change. 

Represents the collection of objects that can be children of an Item class instance. 
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Definition 

Visual Basic Pub ^ c Class ItemEIementCollection 
Inherits CollectionBase 
C# public class ItemElementCollection : CollectionBase 

Managed C++ public gc class ItemElementCollection : public CollectionBase 

JScript public class ItemElementCollection extends CollectionBase 

Members Table 
Inheritance Hierarchy 



Object 



fx] Leave 



CollectionBase 



xj Leave 



ItemElementCollection 

Class Information 

Namespace System.Speech.Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Add Method 



Note: This documentation is preliminary and is subject to change. 
Adds a new Item class instance to the RuleElementCollection. 
Overload List 

public Lit32 Add (Item) 
public Int32 Add (OneOf) 
public Int32 Add (RuleRef) 
public Int32 Add (SpecialRuleRef) 
public Int32 Add (Tag) 
public Int32 Add (Token) 
public Int32 Add (SrssText) 
public Int32 Add (String) 
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public Int32 Add (HtemElement) 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Addltem Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new Item class instance to the ItemElementCollection. 
Overload List 

public Void Addltem (Item) 
public Item Addltem Q 
public Item Addltem (String) 
public Item Addltem (String, String) 
public Item Addltem (String. String, Object) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Addltems Method 

Note: This documentation is preliminary and is subject to change. 
Adds multiple Item class instances to the ItemElementCollection. 
Overload List 

public Item Addltems (String, String) 
public Item Addltems (String, String, String) 
public Item Addltems ( String[]) 

Remarks 

This is essentially a macro for calling Addltem twice. 
This is essentially a macro for calling Addltem three times 
This is essentially a macro for calling Addltem multiple times. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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AddOneOf Method 

Note: This documentation is preliminary and is subject to change. 
Adds a OneOf class instance to the ItemElementCollection. 
Overload List 

public Void AddOneOf (OneOf) 

public OneOf AddOneOf Q 

public OneOf AddOneOf (String. String) 

public OneOf AddOneOf (String. String. String) 

public OneOf AddOneOf (StringQ) 

public OneOf AddOneOf dtem\]) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddOptionalltem Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new optional Item class instance to the ItemElementCollection. 
Overload List 

public Item AddOptionalltem 0 
public Item AddOptionalltem (String) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddRepeatingltem Method 

Note: This documentation is preliminary and is subject to change. 

Adds a new Item class instance to the ItemElementCollection. This instance contains the minimum and 
maximum number of repetitions required for successful recognition. 

Definition 

Public Function AddRepeatingItem( _ 
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ByVal minRepeat As Integer . _ 
Visual Basic ByVal maxRepeat As Integer _ 
) As Item 

public Item AddRepeatingItem( 

int minRepeat, 
int maxRepeat 

); 

public: Item * AddRepeatingItem( 

j ^ , , int minRepeat, 
Managed C++ rr D J 
te int maxRepeat 

); 

public function AddRepeatingItem( 

TO . . minRepeat : int, 
JScnpt . . , 

r maxRepeat : int 

) : Item ; 

Parameters 

. „ , System.Int32. Minimum number of occurrences of the new Item class 
minRepeat . J , 

r instance. 

n , System.Int32. Maximum number of occurrences of the new Item class 
maxRepeat . J . 

* instance. 

Return Value 

System.Speech.Srgs.Item. 

Returns the newly added Item class instance. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

AddRuleRef Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new RuleRef class instance to the ItemElementCollection. 
Overload List 

public Void AddRuleRef (RuleRef) 
public RuleRef AddRuleRef (String) 
public RuleRef AddRuleRef (Rule) 

Remarks 
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This method can also be used to refer to dictation grammars. The general dictation model is 
referenced by: AddRuleRef("recognitiontopic:generar'); and a specific topic. For example: 
AddRuleRef("recognitiontopic:spelling"); 

If the rule is part of the same grammar, the rule reference will be a local reference. 

If the rule is part of another grammar, the rule reference will automatically be determined 
based on the grammar that the rule comes from. 

For example, if the rule is part of a grammar that was loaded with a call to Grammar.Load, 
the URI specified in that call is used and the Rule.Id is used for the local part. For example 
the URI appears in the form: "{0}#{1}", where 0=URI from Grammar.Load, and 
l=Rule.Id. 

Another example is if the rule is part of a grammar that's been built dynamically, the rule is 
automatically added (at Commit time) to the Grammar that this rule reference is a part of, if 
it doesn't already appear there. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddSpecialRuleRef Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new SpecialRuleRef class instance to the ItemElementCollection. 
Definition 

Public Sub AddSpecialRuleRef( _ 
Visual Basic By Val specialRuleRef As SpecialRuleRef _ 

) 

public void AddSpecialRuleRef( 
C# SpecialRuleRef specialRuleRef 

); 

public: void AddSpecialRuleRef ( 
Managed C++ S pecialRuleRef * specialRuleRef 

); 

public function AddSpecialRuleRef( 
JScript specialRuleRef : S pecialRuleRef 
) : void : 

Parameters 

' IR I R f s y stem - s P eech - Sr g s - s P ecialRuleRef - The SpecialRuleRef class instance 
p * being added. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

AddTag Method 

Note: This documentation is preliminary and is subject to change. 
Adds a Tag class instance to the ItemElementCollection. 
Overload List 

public Void AddTag (Ta g) 
public Tag AddTag fString) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddToken Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new Token class instance to the ItemElementCollection. 
Overload List 

public Void AddToken (Token) 
public Token AddToken (String ) 
public Token AddToken (String. String) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Contains Method 

Note: This documentation is preliminary and is subject to change. 

Determines whether the ItemElementCollection contains the specified IltemElement. 

Definition 

Public Function Contains( _ 
Visual Basic ByVal element As IltemElement __ 
) As Boolean 
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public boo! Contains( 
C# IltemElement element 

); 

public: bool Contains( 
Managed C++ IltemElement * element 

); 

public function Contains( 
JScript element : IltemElement 
) : boolean ; 

Parameters 

element System.Speech.SrgsJItemEIement The IltemElement to locate in the 
ItemElementCollection. 

Return Value 

System.Boolean. 

Returns true if the ItemElementCollection contains the specified IltemElement; otherwise, 
false is returned. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

IndexOf Method 



Note: This documentation is preliminary and is subject to change. 
Searches the ItemElement Collection for the specified IltemElement. 
Definition 

Public Function IndexOf( _ 
Visual Basic ByVal element As IltemElement _ 
) As Integ er 

public hit IndexOf( 
C# IltemElement element 

); 

public: int IndexOf( 
Managed C++ IltemElement * element 

); 

public function IndexOf( 
JScript element : ntemElement 
) :int; 
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Parameters 

System.Speech.Srgs.IItemElement. The IltemElement being located within the 
element ItemElementCollectioiL 

Return Value 

System.Int32. 

Returns the zero-based index of the first occurrence of the IltemElement within the 
ItemElementCollection, if found; otherwise, -1 is returned. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Insert Method 

Note: This documentation is preliminary and is subject to change. 

Inserts a new IltemElement into the ItemElementCollection at the specified index location. 
Definition 

Public Sub Insert( _ 

Visual Basic ByVal indeX As - 
visual Basic ByVal dement As ntemEIement _ 

) 

public void Insert( 
int index, 
11 ntemEIement element 

); 

public: void Insert( 

Mana ed C++ int index* 

* IltemElement * element 

); 

public function Insert( 

JScriut indeX : — ' 

^ element : IltemElement 

):void; 

Parameters 

index System.Int32. The zero-based index where the IltemElement is to be inserted. 
element System.Speech.Srgs.IItemElement. The IltemElement to insert. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Note: This documentation is preliminary and is subject to change. 

Initializes a new instance of the ItemElementCollection class and specifies the owning Item class 
instance. 

Definition 

Public Sub ItemEIementCollection( 
Visual Basic ByVal owner As Item _ 

) 

public XtemElementCollection( 
C# Item owner 

); 

public: ItemElementCollection( 
Managed C++ Item * owner 

); 

public function ItemElementCollection( 
JScript owner : Item 

); 

Parameters 

owner System.Speech.Srgs.Item. Item class instance. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnClear Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Protected Sub OnClearO 
C# protected override void OnClear(); 
Managed C++ protected: void OnClearQ; 

JScript protected override function OnClearQ : void : 



© 2003 Microsoft Corporation. All rights reserved. Term s of use. 
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Note: This documentation is preliminary and is subject to change. 



Definition 



Visual Basic 



C# 



Overrides Protected Sub OnInsert( _ 
ByVal index As Integer , _ 
ByVal value As Object _ 

) 

protected override void OnInsert( 
int index, 
object value 

); 

protected: void OnInsert( 

a/t j r± , ial index, 
Managed C++ ™ . , 
fe Object * value 

); 

protected override function OnInsert( 

JScriot index 1 — ' 
^ value : Object 

) : void; 



Parameters 



index System.Int32. 
value System.Object 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnRemove Method 

Note: This documentation is preliminary and is subject to change. 
Definition 



Overrides Protected Sub OnRemove( 

Visual Basic ByVal indeX As In]£eg£E ' - 
Visual Basic ByVa l va/we As Object _ 

) 

protected override void OnRemove( 
c# int index, 

^ object value 

); 
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protected: void OnRemove( 
Managed C++ 0bject , Vfl/ „ g 

); 

protected override function OnRemove( 

TC/ , . . iWex : int, 
Jbcript va/w ^ . Qbject 

) : void ; 



Parameters 



index System.Int32. 
value System.Object 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnSet Method 



Note: This documentation is preliminary and is subject to change. 
Definition 



Overrides Protected Sub OnSet( _ 
By Val index As Integer , _ 
Visual Basic ByVal oldValue As Object _ 
By Val newValue As Object _ 

) 

protected override void OnSet( 
int index, 
C# object oldValue, 

object newValue 

); 

protected: void OnSet( 
int index, 
Managed C++ Object * oldValue, 
Object * newValue 

); 

protected override function OnSet( 

index : int 
JScript oldValue : Object 

newValue : Object 
) : void ; 

Parameters 
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index System.Int32. 
old Value System. Obj ect 
newValue System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnValidate Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub On Validate( _ 
Visual Basic ByVal element As Object _ 

) 

protected override void OnValidate( 
C# object element 

); 

protected: void OnValidate( 
Managed C++ Object * element 

); 

protected override function OnValidate( 
JScript element : Object 
) : void ; 

Parameters 

element System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Remove Method 



Note: This documentation is preliminary and is subject to change. 

Removes the first occurrence of a specific IltemElement from the ItemElementCollection. 
Definition 

Public Sub Remove( _ 
Visual Basic ByVal element As IltemElement _ 

) 



fi1e://C:\WINDOWS\TEMP\~hhEEA9.htm 



—2/9/04 



Interacting with the Computer using Speech Input and Speech Output 



rage /.dj. oi j> j / 



public void Remove( 
C# ntemElement element 

); 

public: void Remove( 
Managed C++ IltemEIement* element 

); 

public function Remove( 
JScript element : IltemEIement 
) : void; 

Parameters 

System.Speech.Srgs.IItemElement. The IltemEIement being removed from the 
element ItemElementCollec tion. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 



Note: This documentation is preliminary and is subject to change. 

Retrieves a child element of the Item class instance from the IltemElementCollection using its index 
value. 

Definition 

Public Property Item( _ 
Visual Basic ByVal index As Integer _ 
) As IltemEIement 
public IltemEIement this[ 

C# int index 

] { get; set; } 

public: property IltemEIement * get_Item( 

int index 

); 

Managed C++ public: property void set_Item( 

int index, 
IltemEIement * 

); 

JScript In JScript, you can use indexed properties, but you cannot define your own. 

Property Value 

System.Speech.Srgs.IItemElement. 
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This property is read/write. 
Parameters 



index S y stem - Int32 Vaiue indicating the child element's location within the 
ItemElementCollection. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OneOf Class 



Note: This documentation is preliminary and is subject to change. 

Represents the World Wide Web Consortium (W3C) Speech Recognition Grammar Specification 
(SRGS) one-of element. See http://www.w3.org/TR/speech-grammar/ for more information. 

Definition 

Public Class OneOf 
Visual Basic Inherits Object 

Implements IltemElement , IRuleElement 

„ public class OneOf : Object 

ntemElement , IRuleElement 

r public gc class OneOf : public Object 

Managed C++ ntemElement > IRuleElement 

public class OneOf extends Object 
cn P implements IRuleElement , IltemElement 

Members Table 
Inheritance Hierarchy 



Object 



fx] Leave 



OneOf 

Class Information 

Namespace System. Speech.Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



1 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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OneOf Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the OneOf class. 
Overload List 

public OneOf 0 
public OneOf (StringH) 
public OneOf (IItemElement[]) 

Examples 

The following code example populates a OneOf element with a list of colors. 

// Build ChangeColor grammar ChangeColorGrammar = new Srgs . SrgsGrammar ( "Ch 

• Build ChangeColor grammar ChangeColorGrammar = New Srgs . SrgsGrammar ( "Cha 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Elements Property 

Note: This documentation is preliminary and is subject to change. 
Gets the collection of all the child elements of the OneOf class instance. 
Definition 

Visual Basic Public ReadOnly Property Elements As OneOfElementCollection 
C# public OneOfElementCollection Elements { get; } 

Managed C++ public: property OneOfElementCollection * get_Elements(); 

JScript public function get ElementsO : OneOfElementCollection 

Property Value 

System.Speech.Srgs.OneOfElementColIection. 

This property is read-only. 

© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 
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OneOfElementCollection Class 



Note: This documentation is preliminary and is subject to change. 

Represents a collection of objects that can be child elements of an OneOf class instance. 

Definition 

. Public Class OneOfElementCollection 
Visual Basic CollectionBase 

C# public class OneOfElementCollection : CollectionBase 

Managed C++ public gc class OneOfElementCollection : public CollectionBase 

JScript . public class OneOfElementCollection extends CollectionBase 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



CollectionBase 



xj Leave 



OneOfElementCollection 

Class Information 

Namespace System.Speech.Srgs 
Assembly System. Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Add Method 

Note: This documentation is preliminary and is subject to change. 
Adds an Item class instance to the the OneOfElementCollection. 
Definition 



Visual Basic Public Function Add( _ 
ByVal item As Item _ 
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) As Integer 

public int Add( 
C# Item item 

); 

public: int Add( 
Managed C++ Item * item 

); 

public function Add( 
JScript item : Item 
):int; 

Parameters 

System.Speech.Srgs.Item. The Item class instance being added to the 
ltem OneOffilementCollection. 

Return Value 

System.Int32. 

The OneOffilementCollection index where the Item class instance has been added. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Addltem Method 



Note: This documentation is preliminary and is subject to change. 
Adds a new Item class instance to the OneOffilementCollection. 
Overload List 

public Void Addltem (Item) 
public Item Addltem Q 
public Item Addltem (String) 
public Item Addltem (String. String) 
public Item Addltem (String, String, Ob j ect) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Addltems Method 
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Note: This documentation is preliminary and is subject to change. 

Adds two Item class instances to the OneOfElementColleciton. Each Item class instance contains text. 

Overload List 

public Item Addltems (String, String) 
public Item Addltems (String. String. String) 
public Item Addltems (String[ ] ) 

Remarks 

This is essentially a macro for calling the Addltem method twice. 
This is essentially a macro for calling the Addltem method three times 
This is essentially a macro for calling the Addltem method multiple times. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddOptionalltem Method 

Note: This documentation is preliminary and is subject to change. 

Adds a new optional Item class instance to the OneOffilementCollection. 

Overload List 

public Item AddOptionalltem Q 
public Item AddOptionalltem (String) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddRepeatingltem Method 

Note: This documentation is preliminary and is subject to change. 

Adds a new Item class instance to the OneOfElementCollection. This instance contains the minimum 
and maximum number of repetitions required for successful recognition. 

Definition 

Public Function AddRepeatingItem( _ 
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ByVal minRepeat As Integer . _ 
Visual Basic ByVal maxRepeat As Integ er _ 
) As Item 

public Item AddRepeatingItem( 

int minRepeat, 
int maxRepeat 

); 

public: Item * AddRepeatingItem( 

Mana ed C++ ~ minRepeat, 
int maxRepeat 

); 

public function AddRepeatingItem( 
. minRepeat : int, 

n P maxRepeat : int 

) : Item ; 

Parameters 

. „ System.Int32. Minimum number of occurrences the new Item object must 
minRepeat J 

^ occur. 

Svstem.Int32. Maximum number of occurrences of the new Item object can 
maxRepeat J 

^ occur. 

Return Value 

System.Speech.Srgs.Item. 

Returns the newly added Item class instance. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Contains Method 

. Note: This documentation is preliminary and is subject to change. 

Determines whether the OneOfElementCollection contains the specified Item class instance. 
Definition 

Public Function Contains( _ 
Visual Basic ByVal item As Item _ 
) As Boolean 

public bool Contains( 
C# Item item 

); 
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public: bool Contains( 
Managed C++ Item * item 

); 

public function Contains( 
JScript item : Item 
) : boolean ; 

Parameters 

System.Speech.Srgs.Item. The Item class instance being located within the 
ltem OneOfElementCollection. 

Return Value 

System.Boolean. 

Returns true if the OneOfElementCollection contains the specified Item class instance; 
otherwise returns false. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IndexOf Method 



Note: This documentation is preliminary and is subject to change. 

Searches for the specified Item class instance and returns the zero-based index of its first occurrence 
within the OneOfElementCollection. 

Definition 

Public Function IndexOf( _ 
Visual Basic ByVal item As Item _ 
) As Integer 

public ml IndexOf( 
C# Item item 

); 

public: int IndexOf( 
Managed C++ Item * item 

); 

public function IndexOf( 
JScript item : Item 
):int; 

Parameters 
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System.Speech.Srgs.Item. The Item class instance being searched for within the 



ltem OneOfElementCollection. 

Return Value 

System.Int32. 

Returrns the zero-based index of the first occurrence of the Item object within the 
OneOfElementCollection, if found; otherwise returns - 1 . 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Insert Method 

Note: This documentation is preliminary and is subject to change. 

Inserts an Item class instance into the OneOfElementCollection at the specified index location. 
Definition 

Public Sub Insert( _ 

Visual Basic ByVal index As IntegeL - 
Visual msic ByVal Uem Ag ^ ^ 

) 

public void Insert( 

hit index, 
Item item 

); 

public: void Insert( 

™ j ^, , int index, 
Managed C++ lJsm * item 

); . 

public function Insert( 
TO . index : int, 

38en P t item : Item 

) : void : 

Parameters 

, Svstem.Int32. The zero-based index location where the Item class instance is to be 
index . J , , 
inserted. 

item System.Speech.Srgs.Item. The Item class instance being inserted. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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OnClear Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Protected Sub OnClearO 
C# protected override void OnClearO; 
Managed C++ protected: void OnClearO; 

JScript protected override function OnClearQ : void ; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

OneOfElementCollection Method 



Note: This documentation is preliminary and is subject to change. 

Initializes a new instance of the OneOfElementCollection and specifies the owning OneOf class 
instance. 

Definition 

Public Sub OneOfElementCollection( _ 
Visual Basic ByVal owner As OneOf _ 

) 

public OneO£ElementCoIlection( 
C# OneOf owner 

); 

public: OneOfElementCollection^ 
Managed C++ OneOf * owner 

); 

public function OneOfElementCollection( 
JScript owner : OneOf 

); 

Parameters 



owner System.Speech.Srgs.OneOf. Owning OneOf class instance. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
fil^;//rAWT7sJnOWS\TRMPWhhKRA"^ht^ 



Interacting with the Computer using Speech Input and Speech Output i^age 242 of 35 / 

Onlnsert Method 

Note: This documentation is preliminary and is subject to change. 
Definition 



Overrides Protected Sub OnInsert( _ 

Visual Basic ByVal index A§ MmL ' - 
visual Basic ByVal vdm M Qbject _ 

) 

protected override void OnInsert( 
£g int index, 

object value 

); 

protected: void OnInsert( 

•» jt j ~, . int index, 
Managed C++ Qbject , value 

); 

protected override function OnInsert( 

TC . . index : int, 
Jbcript yalue . Qbject 

) : void; 



Parameters 



index System.Int32. 
value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnRemove Method 



Note: This documentation is preliminary and is subject to change. 
Definition 



Visual Basic 



C# 



Overrides Protected Sub OnRemove( 
ByVal index As Integer , _ 
ByVal value As Object _ 

) 

protected override void OnRemove( 
int index, 
object value 

); 
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protected: void OnRemove( 

i i i inl index, 
Managed C++ 0bject * va i ue 

); 

protected override function OnRemove( 
TO . index : int, 

JScri ^ value : Object 

) : void ; 



Parameters 



index System.Int32. 
value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnSet Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnSet( _ 
By Val index As Integer . _ 
Visual Basic ByVal oldValue As Object , _ 
By Val newValue As Object _ 

) 

protected override void OnSet( 
int index, 
C# object oldValue, 

object newValue 

); 

protected: void OnSet( 
int index, 
Managed C++ Object * oldValue, 
Object * newValue 

); 

protected override function OnSet( 

index : int 
JScript oldValue : Object 

newValue : Object 
) : void ; 

Parameters 
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index System.Int32. 
oldValue System.Object. 
new Value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnValidate Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnValidate( __ 
Visual Basic ByVal item As Object _ 

) 

protected override void OnValidate( 
C# object item 

); 

protected: void OnValidate( 
Managed C++ Object * item 

); 

protected override function On Validate( 
JScript item : Object 
) : void ; 

Parameters 

item System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Remove Method 



Note: This documentation is preliminary and is subject to change. 

Removes the first occurrence of the specified Item class instance from the OneOfElementCollection. 
Definition 

Public Sub Remove( _ 
Visual Basic ByVal item As Item _ 

) 
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public void Remove( 
C# Item item 

); 

public: void Removef 
Managed C++ Item * item 

); 

public function Remove( 
JScript item : Item 
) : void; 

Parameters 

System.Speech.Srgs.Item. The Item class instance to remove from the 
ltem OneOffilementCollection. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 

Note: This documentation is preliminary and is subject to change. 

Retrieves an Item class instance from the OneOffilementCollection using the specified index. 
Definition 

Public Property Item( _ 
Visual Basic ByVal index As Integer _ 
) As Item 

public Item this[ 
C# int index 

] { get; set; } 

public: property Item * get_Item( 

int index 

); 

Managed C++ public: property void set_Item( 

int index. 
Item * 

); 

JScript In JScript, you can use indexed properties, but you cannot define your own. 

Property Value 

System.Speech.Srgs.Item. 

This property is read/write. 
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Parameters 

index System.Int32. Index value. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

PropertyTag Class 



Note: This documentation is preliminary and is subject to change. 

Represents the World Wide Web Consortium (W3C) Speech Recognition Grammar Specification 
(SRGS) tag element with SAPI Properties. See http://www.w3.org/TRyspeech-grammar/ for more 
information. 

Definition 

Public Class PropertyTag 
Visual Basic Inherits Object 

Implements HtemElement . IRuleElement 

public class PropertyTag : Object . 
C# * HtemElement IRuleElement 

h r++ P ublic § c class PropertyTag : public Object * 

Managed C++ ntemElemeat . IRuleElement 

• f public class PropertyTag extends Object 
cn P implements IRuleElement HtemElement 

Members Table 
Inheritance Hierarchy 



Object 



5 Leave 



PropertyTag 

Class Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral 5 

Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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PropertyTag Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the PropertyTag class. 
Overload List 

public PropertyTag Q 
public PropertyTag (String) 
public PropertyTag (String, Object) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 

Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Public Function ToString() As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the name of the semantic property contained within the PropertyTag class instance. 
Definition 

Visual Basic Public Property Name As Strin g 
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C# public string Name { get; set; } 

ivr j n . . public: property String * get_Name(); 
Managed C++ puWic . _p roperty void S et_Name(Strmg*); 

to • t public function get NameO : String 
p public function set Name (String ); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Value Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the value of semantic property contained within the PropertyTag class instance. 
Definition 

Visual Basic Public Property Value As Object 
C# public object Value { get; set; } 

Man aaPri r++ P ublic: — P ro P ert y Object* get_Value(); 
ivianagea «^ pubUc: _p roperty void se t Value( Object *); 

K . public function get ValueO : Object 
script pubUc fy^fi^ set Value(Object); 

Property Value 

System.Object 

This property is read/write. . 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Rule Class 



Note: This documentation is preliminary and is subject to change. 

Represents the World Wide Web Consortium (W3C) Speech Recognition Grammar Specification 
(SRGS) rule element. See http://www.w3c.org/TR/speech-grammar/ for more information. 
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Definition 

. „ . Public Class Rule 
Visual Bas.c Object 

C# public class Rule : Object 

Managed C++ public gc class Rule : public Object 

JScript public class Rule extends Object 

Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



Rule 

Class Information 



Namespace System. Speech. Srgs 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetXml Method 



Note: This documentation is preliminary and is subject to change. 

Gets the Extensible Markup Language (XML) markup for this Rule class instance. 

Definition 

Visual Basic Public Function GetXmlO As String 

C# public string GetXml(); 
Managed C++ public: String * GetXmlQ; 

JScript public function GetXml() : String ; 

Return Value 

System.String. 

Retrurns the XML markup of the Rule class instance. 
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© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

Rule Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the Rule class. 
Overload List 

public Rule 0 
public Rule (String) 

Remarks 

If the Name property is not set prior to commiting the grammar that contains this rule, a 
unique name is assigned automatically. 

The name property refers to the ID property of the RULE W3C SRGS element. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 

Note: This documentation is preliminary and is subject to change. 
Returns a string representation of this Rule class instance. 
Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO " String ; 

Return Value 

System.String. 

Returns a text string describing the Rule class instance. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Elements Property 



Note: This documentation is preliminary and is subject to change. 
Gets the collection of all the child elements of the Rule class instance. 
Definition 

Visual Basic Public ReadOnly Property Elements As RuleElementCollection 

C# public RuleElementCollection Elements { get; } 
Managed C++ public: property RuleElementCollection * get_Elements(); 
JScript public function get Elements() : RuleElementCollection 

Property Value 

System.Speech.Srgs.RuleElementCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Id Property 



Note: This documentation is preliminary and is subject to change. 



Gets and sets the name of the Rule class instance. 



Definition 



Managed C++ 



Visual Basic 
C# 



JScript 



Public Property Id As String 

public string Id { get; set; } 

public: property String * get_Id(); 

public: property void set_Id( String 

public function get Id() : String 
public function set Id( Strin g): 



Property Value 



System.String. 



This property is 



read/write. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Scope Property 

Note: This documentation is preliminary and is subject to change. 

Gets and Sets how a rule is referenced by other rules, and whether or not the rale can be activated or not. 
See RuleScope for more information. 

Definition 

Visual Basic Public Property Scope As RuleScope 

C# public RuleScope Scope { get; set; } 

public: property RuleScope get_Scope(); 

Managed C++ pubUc . _p roperty void set^Scopef RuleScope ): 

. public function get ScopeO RuleScope 
cnp public function set Scope (RuleScope ); 

Property Value 

System.Speech.Srgs.RuleScope. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleCollection Class 

Note: This documentation is preliminary and is subject to change. 

Represents a collection of objects that can be child elements of a Rule class instance. 

Definition 

Visual Basic ^ u ^^ c Class RuleCollection 

Inherits CollectionBase 

C# public class RuleCollection : CollectionBase 

Managed C++ public gc class RuleCollection : public CollectionBase 

JScript public class RuleCollection extends CollectionBase 

Members Table 
Inheritance Hierarchy 
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fx] Leave 

Object 1 



CollectionBase 



3 Leave 



RuIeColIection 

Class Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Add Method 

Note: This documentation is preliminary and is subject to change. 

Adds a Rule class instance to the RuIeColIection. 

Definition 

Public Function Add( _ 
Visual Basic ByVal rule As Rule _ 
) As Integer 

public wt Add( 
C# Rule rule 

); 

public: int Add( 
Managed C++ Rule * rule 

); 

public function Add( 
JScript rule : Rule 
) : int; 

Parameters 

j System.Speech.Srgs.Rule. The Rule class instance being added to the 
RuIeColIection. 

Return Value 

System.Int32. 
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The RuleCollection index at which the value has been added. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddRule Method 

Note: This documentation is preliminary and is subject to change. 
Adds a new Rule class instance to the RuleCollection. 
Overload List 

public Rule AddRule 0 
public Rule AddRule (String) 
public Rule AddRule (Rule) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Contains Method 



Note: This documentation is preliminary and is subject to change. 

Determines whether the RuleCollection contains the specified Rule class instance. 

Definition 

Public Function Contains( _ 
Visual Basic ByVal rule As Rule _ 
) As Boolean 

public bool Contains( 
C# . Rule rule 

); 

public: bool Contains( 
Managed C++ Rule * rule 

); 

public function Contains( 
JScript rule : Rule 
) : boolean ; 

Parameters 



System.Speech.Srgs.Rule The Rule class instance being located within the 
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RuleCollection. 
Return Value 

System.Boolean. Returns true if the RuleCollection contains the specified Rule class 
instance; otherwise returns false. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

getltem Method 

Note: This documentation is preliminary and is subject to change. 

Overload List 

public Rule get^Item (Int32) 
public Rule get ltem (String) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IndexOf Method 

Note: This documentation is preliminary and is subject to change. 

Searches for the specified Rule class instance and returns the zero-based index of its first occurrence 
within the RuleCollection. 

Overload List 

public Int32 IndexOf (Rule) 
public Int32 IndexOf (String) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Insert Method 

Note: This documentation is preliminary and is subject to change. 

Inserts a Rule class instance into the RuleCollection at the specified index location. 
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Definition 

Public Sub Insert( _ 

Visual Basic ByVal indeX As Iateg££> - 
Visual Basic fiyVal ^ Ag ^ 

) 

public void Insert( 
^ u injt index, 

^ n Rule rule 

); 

public: void Insert( 

_ _ _j i isl index, 
Managed C++ Rule , mk 

); 

public function Insert( 
TO . , zmfex : int, 
3Scn P t rule : Rule 

) : void ; 

Parameters 

. , Svstem.Int32. The zero-based index location where the Rule class instance is to be 
index . , 
inserted. 

rule System.Speech.Srgs.Rule. The Rule class instance being inserted. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnClear Method 

Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Protected Sub OnClearO 
C# protected override void OnClearO; 
Managed C++ protected: void OnClearO; 

JScript protected override function OnClearO : void ; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Onlnsert Method 
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Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnInsert( _ 

. _ . ByVal index As Integer , 
Visual Basic ByVal ^ Ag - 

) 

protected override void OnInsert( 
£ „ mt index, 

object value 

); 

protected: void OnInsert( 

1%/r j ^, ■ mt index, 
Managed C++ Qbject * value 

); 

protected override function OnInsert( 
™ . . index : int, 
^ value : Object 

) : void : 

Parameters 

index System.Int32. 
value System.Object 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnRemove Method 

Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnRemove( _ 

Visual Basic ByVal index As InMgeE ' - 
visual aasic B yVal va/we As Object _ 

) 

protected override void OnRemove( 
c# int index, 

object value 

); 

protected: void OnRemove( 
Managed C++ Mindex> 

Object * value 
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); 

protected override function OnRemove( 

. index : hit, 

Script vahe . Qbject \ 

) : void ; 



Parameters 



index System.Int32. 
value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnSet Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnSet( _ 
ByVal index As Integ er, _ 
Visual Basic ByVal oldValue As Object, _ 
ByVal new Value As Object _ 

) 

protected override void OnSet( 
int index, 
C# object oldValue, 

obj ect new Value 

); 

protected: void OnSet( 
int index, 
Managed C++ Object * oldValue, 
Object * newValue 

); 

protected override function OnSet( 

index : int 
JScript oldValue : Object. 

newValue : Object 
) : void : 

Parameters 

index System.Int32. 
oldValue System.Object. 
newValue System.Object. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

On Validate Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnValidate( _ 
Visual Basic ByVal rule As Object _ 

) 

protected override void OnValidate( 
C# object rule 

); 

protected: void OnValidate( 
Managed C++ Object * rule 

■); 

protected override function OnVaIidate( 
JScript rule : Object 
) : void ; 

Parameters 

rule System.Object. 



© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

Remove Method 



Note: This documentation is preliminary and is subject to change. 

Removes the first occurrence of a specified Rule class instance from the RuleCollection. 

Definition 



Public Sub Remove( _ 
Visual Basic ByVal rule As Rule _ 

) 

public void Remove( 
C# Rule rule 

); 

Managed C++ public: ^ Remove ( 
Managed C++ * ^ 
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); 

public function Remove( 
JScript rule : Rule 
) : void ; 



Parameters 



, System.Speech.Srgs.Rule. The Rule class instance to remove from the 
mle RuleCollection. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleCollection Method 

Note: This documentation is preliminary and is subject to change. 

Initializes a new instance of the RuleCollection and species the owning Grammar class instance. 
Definition 

Public Sub RuleCollection( _ 
Visual Basic ByVal owner As SrgsGrammar _ 

) 

public RuleCollection( 
C# SrgsGrammar owner 

); 

public: RuIeCollection( 
Managed C++ SrgsGrammar * owner 

); 

public function RuleCollection( 
JScript owner : SrgsGrammar 

); 

Parameters 

owner System.Speech.Srgs.SrgsGrammar. Owning Grammar class instance. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

setltem Method 

Note: This documentation is preliminary and is subject to change. 
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Overload List 



public Void set Jtem Qnt32. Rule) 
. public Void setjtem ^String. Rule) 



© 2003 Microsoft Corporation* All rights reserved. Terms of use. 

Item Property 



Note: This documentation is preliminary and is subject to change. 

Retrieves a Rule class instance from the RuleCollection using the specified name. 

Overload List 



public Rule Item (String) 
public Rule Item Qnt32) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleElementCollection Class 



Note: This documentation is preliminary and is subject to change. 
Represents a collection of objects that are valid within a Rule class instance. 
Definition 

Visual Basic ^ u ^° Class RuleElementCollection 

Inherits CollectionBase 

C# public class RuleElementCollection : CollectionBase 

Managed C++ public gc class RuleElementCollection : public CollectionBase 

JScript public class RuleElementCollection extends CollectionBase 

Members Table 
Inheritance Hierarchy 



Object 



5 Leave 



CollectionBase 



fx] Leave 
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RuIeElementCoIlection 

Class Information 

Namespace System.Speech.Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bh27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Add Method 



Note: This documentation is preliminary and is subject to change. 
Adds an Example class instance to the RuIeElementCoIlection. 
Overload List 

public Int32 Add (Example) 
public Int32 Add (Item) 
public Int32 Add (OneOf) 
public Int32 Add (RuleRef) 
. public Int32 Add (SpecialRuleRef) 
public Int32 Add (Tag) 
public Int32 Add (Token) 
public Int32 Add (SrgsText) 
public Int32 Add (String ) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddExample Method 



Note: This documentation is preliminary and is subject to change. 
Adds a Example class instance to the RuIeElementCoIlection. 
Overload List 

public Void AddExample (Example) 
public Example AddExample (String) 
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© 2003 Microsoft Corporation. AH rights reserved. Terms of use, 

Addltem Method 

Note: This documentation is preliminary and is subject to change. 
Adds a Item class instance to the RuleElementCollection. 
Overload List 

public Void Addltem (Item) 
public Item Addltem Q 
public Item Addltem (String) 
public Item Addltem (String, Strin g) 
public Item Addltem (String, String, Object) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Addltems Method 

Note: This documentation is preliminary and is subject to change. 

Adds two Item class instances to the RuleElementCollection. Both Item class instances contain text. 

Overload List 

public Item Addltems (String, String) 
public Item Addltems (String, String, String) 
public Item Addltems (String[]) 

Remarks 

This method is essentially a macro for calling the Addltem method twice. 
This method is essentially a macro for calling the Addltem method three times 
This method is essentially a macro for calling the Addltem method multiple times. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Note: This documentation is preliminary and is subject to change. 
Adds a OneOf class instance to the RuleElementCollection. 
Overload List 

public Void AddOneOf f OneOf) 

public OneOf AddOneOf 0 

public OneOf AddOneOf rString. String! 

public OneOf AddOneOf (String. String. String! 

public OneOf AddOneOf (StringflV 

public OneOf AddOneOf (ItemQ) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddOptionalltem Method 



Note: This documentation is preliminary and is subject to change. 

Adds a new optional Item class instance to the RuleElementCollection. 

Overload List 

public Item AddOptionalltem 0 
public Item AddOptionalltem (String) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddRepeatingltem Method 



Note: This documentation is preliminary and is subject to change. 

Adds an Item class instance to the RuleElementCollection. The Item class instance being added either 
must be repeated the specified minimum number of times, or can be repeated up to the specified 
maximum number of times. 

Definition 
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Public Function AddRepeatingItem( _ 

Vicii*i ByVal minRe P eat As Integer, _ 

v lsuai » asic gy w maxRepeat As integer _ 

) As Item 

public Item AddRepeatingItem( 

£g |nt minRepeat, 

^ int maxRepeat 

); 

public: Item * AddRepeatingItem( 

™ , ^ , . int minRepeat, 
Managed C++ — D ? 
fe int maxRepeat 

); 

public function AddRepeatingItem( 

„ . minRepeal Jnt, 

" maxRepeat : int 

) :Item; 

Parameters 

. „ System.Int32. Minimum number of times the new Item class instance must be 
minRepeat J ^ , v 
^ repeated for a successful recognition. 

« System.Int32. Maximum number of times the new Item class instance can be 
max epea r q )ea t^-f orasuccess fy reM g n itj on- 

Return Value 

System.Speech.Srgs.Item. 

Returns the newly added Item class instance. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddRuleRef Method 

Note: This documentation is preliminary and is subject to change. 
Adds a RuleRef class instance to the RuleElementCollection. 
Overload List 

public Void AddRuleRef (RuleRef) 
public RuleRef AddRuleRef (String ) 
public RuleRef AddRuleRef (Rule) 

Remarks 
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This method can also be used to refer to dictation grammars. The general dictation model is 
referenced by: AddRuleRef( n recognitiontopic: general"); and a specific topic by, for 
example: AddRuleRef( M recognitiontopic:spelling M ); 

If the rule is part of the same grammar, the rule reference is a local reference. If the rule is 
part of another grammar, the rule reference is automatically determined based on the 
grammar that the rule comes from. 

For example, if the rule is part of a grammar that was loaded with a call to Grammar.Load, 
the URI specified in that call will be used and the Rule.Id will be used for the local part.The 
URI will appear in the form: "{0}#{1}", where 0=URI from Grammar.Load, and l=Rule.Id. 
Another example is if the rule is part of a grammar that's been built dynamically the rule 
will automatically be added (at Commit time) to the Grammar that this rule reference is a 
part of, if it doesn't already appear there. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AddSpecialRuleRef Method 

Note: This documentation is preliminary and is subject to change. 
Adds a SpecialRuleRef class instance to the RuleElementCollection. 
Definition 

Public Sub AddSpecialRuleRef( _ 
Visual Basic ByVal specialRuleRef As SpecialRuleRef _ 

) 

public void AddSpecialRuleRef( 
C# SpecialRuleRef specialRuleRef 

); 

public: void AddSpecialRuleRef ( 
Managed C++ SpecialRuleRef * specialRuleRef 

); 

public function AddSpecialRuleRef 
JScript specialRuleRef: S pecialRuleRef 
) : void ; 

Parameters 

jp r J? f System.Speech.Srgs.SpecialRuleRef. The SpecialRuleRef class instance 
specialKuleKeJ fo ^ RuleElementCollect i on . 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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AddTag Method 

Note: This documentation is preliminary and is subject to change. 
Adds a Tag class instance to the RuleElementCollection. 
Overload List 

public Void AddTag (Tag) 
public Tag AddTag (String) 

© 2003 Microsoft Coiporation. All rights reserved. Terms of use. 

AddToken Method 

Note: This documentation is preliminary and is subject to change. 
Adds a Token class instance to the RuleElementCollection. 
Overload List 

public Void AddToken (Token) 
public Token AddToken (String) 
public Token AddToken (String, String ) 

© 2003 Microsoft Coiporation. All rights reserved. Terms of use. 

Contains Method 

Note: This documentation is preliminary and is subject to change. 

Determines whether the RuleElementCollection contains the specified IRuleElement. 

Definition 

Public Function Contains(_ 
Visual Basic ByVal element As IRuleElement _ 
) As Boolean 

public bool Contains( 
C# IRuleElement element 

); 
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public: bool Contains( 
Managed C++ IRuleElement * element 

); 

public function Contains( 
JScript element : IRuleElement 
) : boolean : 

Parameters 

element s y stem - s P eech - Sr g s - IRuIeElement - ^ IRuleElement being located within the 
RuleElementCollection. 

Return Value 

System.Boolean. 

Returnstrue if the RuleElementCollection contains the specified IRuleElement object; 
otherwise returns false. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IndexOf Method 



Note: This documentation is preliminary and is subject to change. 

Searches for the specified IRuleElement and returns the zero-based index of its first occurrence within 
the RuleElementCollection. 

Definition 

Public Function IndexOf( _ 
Visual Basic ByVal element As IRuleElement _ 
) As Integer 

public |nt IndexOf( 
C# IRuleElement element 

); 

public: int IndexOf( 
Managed C++ IRuleElement * element 

); 

public function IndexOf( 
JScript element : IRuleElement 
) :int; 

Parameters 
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System.Speech.Srgs.IRuleElement. The IRuleElement being searched for within 
element ^ Ru i e ElementCollection. 

Return Value 

System.Int32. 

Returns the zero-based index of the first occurrence of the IRuleElement object within the 
RuieElementCollection, if found; otherwise returns -1 . 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Insert Method 

Note: This documentation is preliminary and is subject to change. 

Inserts a new IRuleElement into the RuieElementCollection at the specified index location. 
Definition 

Public Sub Insert( _ 

Visual Basic ByVal indeX As Inie8fiL - 

v lsuai uasic ByVal dement As IRuleElement _ 

) 

public void Insert( 

mt index, 

IRuleElement element 

); 

public: void Insert( 

Mana ed C++ ~ index, 

**■ IRuleElement * element 

); 

public function Insert( 
T<i . index : jyat, 

Jfccnpt e i emen t : IRuleElement 

) : void; 

Parameters 

. , System.Int32. The zero-based index location where the IRuleElement is being 
index . j 
mserted. 

element System.Speech.Srgs.IRuleElement. The new IRuleElement being inserted. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use 
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Note: This documentation is preliminary and is subject to change. 



Definition 



Visual Basic Overrides Protected Sub OnCIearQ 
C# protected override void OnClear(); 
Managed C++ protected: void OnClearO; 

JScript protected override function OnCIearQ : void ; 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Onlnsert Method 

Note: This documentation is preliminary and is subject to change. 
Definition 



Visual Basic 



C# 



Overrides Protected Sub OnInsert( _ 
ByVal index As Integ er. _ 
By Val value As Object _ 

) 

protected override void OnInsert( 
int index, 
object value 

); 

protected: void OnInsert( 

■mjr . int index, 

Managed C++ Qbject * valm 

); 

protected override function OnInsert( 

JScriot indeX : — ' 
P value : Object 

) : void ; 



Parameters 

index System.Int32. 
value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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OnRemove Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub OnRemove( _ 

Visual Basic ByVal indeX As Imte g er » - 
Visual Basic ByVaJ mlue Ag Qbject _ 

) 

protected override void OnRemove( 
^ tat index, 

object value 

); 

protected: void OnRemove( 

Mana ed C++ ~ index, 

* Object * value 

); 

protected override function OnRemove( 

JScrint indeX ' — 9 
p value : Object 

) : void : 

Parameters 

index System.Int32. 
value System.Object. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnSet Method 



Note: This documentation is preliminary and is subject to change. 



Definition 



Overrides Protected Sub OnSet( 
ByVal index As Integer , _ 
Visual Basic ByVal oldValue As Object _ 
ByVal newValue As Object _ 

) 

protected override void OnSet( 
C# mt index, 

object oldValue, 
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object newValue 

); 

protected: void OnSet( 
int index, 
Managed C++ Object * oldValue, 
Object * newValue 

); 

protected override function OnSet( 

index : int 
JScript oldValue : Object 

newValue : Object 
) : void : 



Parameters 



index System.Int32. 
old Value System. Obj ec t . 
newValue System.Object 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

OnValidate Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Overrides Protected Sub On Validate( _ 
Visual Basic ByVal element As Object _ 

) 

protected override void OnValidate( 
C# object element 

); 

protected: void OnValidate( 
Managed C++ Object * element 

protected override function OnValidate( 
JScript element : Object 
) : void : 

Parameters 

element System.Object. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Remove Method 

Note: This documentation is preliminary and is subject to change. 

Removes the first occurrence of a specified IRuleElement from the RuleElementCollection. 
Definition 

Public Sub Remove( _ 
Visual Basic ByVal element As IRuleElement _ 

) 

public void Remove( 
C# IRuleElement element 

); 

public: void Remove( 
Managed C++ IRuleElement * element 

); 

public function Remove( 
JScript element : IRuleElement 
) : void : 

Parameters 

element s y stem - s P eech - Sr g s - IRuIeElement - ^ IRuleElement being removed from the 
RuleElementCollection. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleElementCollection Method 

Note: This documentation is preliminary and is subject to change. 

Creates a new RuleElementCollection and identifies its owning Rule class instance. 

Definition 

Public Sub RuleElementCollection( _ 
Visual Basic ByVal owner As Rule _ 
) 

public RuleElementCoIlection( 
C# Rule owner 

); 
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public: RuleElementCollection( 
Managed C++ Rule * owner 

); 

public function RuleElementCollection( 
JScript owner : Rule 

); 

Parameters 

System.Speech.Srgs.Rule. Name of the Rule class instance associated with the 
owner R u i e Ei emen tc 0 ii ec ti 0 n. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Item Property 



Note: This documentation is preliminary and is subject to change. 

Retrieves an IRuleElement from the RuleElementCollection using a specified index value. 
Definition 

Public Property Item( _ 
Visual Basic ByVal index As Integer _ 
) As IRuleElement 

public IRuleElement this[ 

C# int index 

] { get; set; } 

public: property IRuleElement * get_Item( 

int index 

); 

Managed C++ public: property void set_Item( 

in t index, 
IRuleElement * 

); 

JScript In JScript, you can use indexed properties, but you cannot define your own. * 

Property Value 

System.Speech.Srgs.IRuleElement. 

This property is read/write. 
Parameters 
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index System.Int32. Index value of the IRuleElement within the RuleElementCollection. 



© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

RuleRef Class 



Note: This documentation is preliminary and is subject to change. 

Example represents the World Wide Web Consortium (W3C) Speech Recognition Grammar 
Specification (SRGS) ruleref element. See http://www.w3.org/TR/speech-grammar/ for more 
information. 

Definition 



Public Class RuleRef 
Visual Basic Inherits Object 

Implements IltemElement , IRideElement 

r „ public class RuleRef : Object . 

IltemElement IRuleElement 

public gc class RuleRef : public Object , 

Managed C++ ntemElement IRuleElement 

to • f public class RuleRef extends Object 

P implements IRuleElement , IltemElement 



Members Table 
Inheritance Hierarchy 



Object 



fxj Leave 



RuleRef 

Class Information 



Namespace System.Speech.Srgs 

Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleRef Method 
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Note: This documentation is preliminary and is subject to change. 
Class constructor 
Overload List 

public RuleRef Q 
public RuleRef (String) 
public RuleRef (Rule) 

Remarks 

If the rule is part of the same grammar, the rule reference is a local reference. If the rule is 
part of another grammar, the rule reference is automatically determined based on the 
grammar that the rule comes from. 

For example, if the rule is part of a grammar that was loaded with a call to Grammar.Load, 
the XJRI specified in that call will be used and the Rule.Id will be used for the local part. 

For example the URI will appear in the form: "{0}#{1} M , where 0=URI from 
Grammar.Load, and l=Rule.Id. Another example is if the rule is part of a grammar that's 
been built dynamically the rule will automatically be added (at Commit time) to the 
Grammar that this rule reference is a part of, if it doesn't already appear there. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System.String. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Note: This documentation is preliminary and is subject to change. 

The Dictation SpecialRuleRef defines a rule that may match speech that matches the associated 
Dictation topic specified in the containing Grammar object. 



Visual Basic Public Shared ReadOnly Property Dictation As RuleRef 



Managed C++ public: property static RuleRef * get_Dictation(); 

JScript public static function get Dictation() : RuleRef 

Property Value 

System.Speech.Srgs.RuleRef. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 



Note: This documentation is preliminary and is subject to change. 

Gets and sets the universal resource indicator (URI) of the rule to which this RuleRef object refers. 
Definition 

Visual Basic Public Property Uri As String 



Definition 



C# 



public static RuleRef Dictation { get; } 



Uri Property 



Managed C++ 



JScript 



C# 



public string Uri { get; set; } 

public: property String* getJUriO; 

public: property void set_Uri( String *): 

public function get Uri() : String 
public function set Uri( String ): 



Property Value 



System.String. 



This property is 



read/write. 
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Remarks 

This can also be used to refer to dictation grammars. The general dictation model is 
referenced by: AddRuleRefC'recognitiontopicrgeneral"); and a specific topic by, for 
example: AddRuleRef( ,! recognitiontopic:spelling M ); 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpecialRuleRef Class 



Note: This documentation is preliminary and is subject to change. 

SpecialRuleRef class instance allow grammars based on context-free grammars (CFG) to have powerful 
additional features, such as transitions into dictation (both recognized or not recognized) and word 
seqeuences from SAPI 5.0. 



Definition 



Public Class SpecialRuleRef 
Visual Basic Inherits Object 

Implements IltemElement . IRuleElement 

g public class SpecialRuleRef : Object , 
IltemElement IRuleElement 

M , r public gc class SpecialRuleRef : public Object * 

Managed C++ memElement IRuleElement 

to • t public class SpecialRuleRef extends Object 
P implements IRuleElement IltemElement 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SpecialRuleRef 

Class Information" 

Namespace System. Speech.Srgs 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0;4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Garbage Property 

Note: This documentation is preliminary and is subject to change. 

Gets the Garbage SpecialRuleRef that specifies a rule that may match any speech up until the next rule 
match, the next token or until the end of spoken input. 

Definition 

Visual Basic Public Shared ReadOnly Property Garbage As SpecialRuleRef 
C# public static SpecialRuleRef Garbage { get; } 

Managed C++ public: property static SpecialRuleRef * get_Garbage(); 

JScript public static function get GarbageQ : SpecialRuleRef 

Property Value 

System.Speech.Srgs.SpecialRuleRef. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Null Property 

Note: This documentation is preliminary and is subject to change. 

Gets The Null SpecialRuleRef that specifies a rule that is automatically matched without the user 
speaking any word. 

Definition 

Visual Basic Public Shared ReadOnly Property Null As S pecialRuleRef 
C# public static SpecialRuleRef Null { get; } 

Managed C++ public: property static SpecialRuleRef * get_Null(); 

JScript public static function get NuI10 : S pecialRuleRef 

Property Value 

System.Speech.Srgs.SpecialRuleRef. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Type Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the type of a SpecialRuleRef class instance that specifies the behavior of the reference. 
Definition 

Visual Basic Public Property Type As SpecialRuleRefType 
C# public SpecialRuleRefTyp e Type { get; set; } 

M*n*aPd r++ P ublic: _JProperty SpecialRuleRefType get JTypeQ; 
ivianagea Lrr public: _p roperty vo jd setjrypef SpecialRuleRefType ^ 

to • t public function get TypeQ : SpecialRuleRefType 
^ public function set Type( SpecialRuleRefTyp e); 

Property Value 

System.Speech.Srgs.SpecialRuleRefType. 

This property is read/write. 
Remarks 

The type of the special rule reference specifies the behavior of the reference. For example, a 
special rule reference with a type of SpecialRuleRefType.Dictation, when included in a 
Rule, allows the rule to also include dictation as part of its context-free grammar 
recognition. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Void Property 

Note: This documentation is preliminary and is subject to change. 

Gets the Void SpecialRuleRef that specifies a rule that can never be spoken. Inserting Void into a 
sequence automatically makes that sequence unspeakable. 

Definition 

Visual Basic Public Shared ReadOnly Property Void As SpecialRuleRef 
C# public static SpecialRuleRef Void { get; } 

. fiW/P AWTMnOWSNTFAAPWhhF.R A9.htm ~ " ' 2/3/04 
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Managed C++ public: property static S pecialRuleRef * get_Void(); 

JScript public static function get Void() : SpecialRuleRef 

Property Value 

System.Speech.Srgs.SpecialRuleRef. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

WordSequence Property 

Note: This documentation is preliminary and is subject to change. 

Gets the WordSequence SpecialRuleRef that species a rule that may match recognized speech from an 
assosciated text buffer, or word sequence, on the containing Grammar class instance. 

Definition 

Visual Basic Public Shared ReadOnly Property WordSequence As SpecialRuleRef 

C# public static SpecialRuleRef WordSequence { get; } 
Managed C++ public: _property static S pecialRuleRef * get_WordSequence(); 
JScript public static function get WordSequenceQ : SpecialRuleRef 

Property Value 

System.Speech.Srgs.SpecialRuleRef. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SrgsGrammar Class 

Note: This documentation is preliminary and is subject to change. 
Represents the logical housing for individual rules and dictation grammars. 
Definition 

Visual Basic Publ i c class SrgsGrammar 
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Inherits Grammar 
C# public class SrgsGrammar : Grammar 

Managed C++ public gc class SrgsGrammar : public Grammar 

JScript public class SrgsGrammar extends Grammar 

Members Table 
Inheritance Hierarchy 



Object 



[x| Leave 



Grammar 

SrgsGrammar 



Class Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Commit Method 

Note: This documentation is preliminary and is subject to change. 

Commits any changes to this SrgsGrammar class instance to the underlying Recognizer. 

Definition 

Visual Basic Public Sub CommitO 
C# public void CommitO; 
Managed C++ public: void CommitO; 

JScript public function CommitO : void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetXml Method 

Note: This documentation is preliminary and is subject to change. 
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Gets the markup representing this SrgsGrammar class instance. 
Definition 

Visual Basic Public Function GetXmlO As String 

C# public string GetXmI(); 
Managed C++ public: String * GetXml(); 

JScript public function GetXmlQ : String : 

Return Value 

System.String. 

Returns the markup representing the SrgsGrammar class instance. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Initialize Method 

Note: This documentation is preliminary and is subject to change. 
Initializes an SrgsGrammar object from an input/output stream. 
Definition 

Public Sub Initialize( _ 
Visual Basic ByVal stream As Stream _ 
) 

public void Initialize( 
C# Stream stream 

); 

public: void Initialize( 
Managed C++ Stream * stream 

);" 

public function Initialize( 
JScript stream : Stream 
) : void : 

Parameters 

System.IO.Stream. Stream from which to load and initialize the SrgsGrammar 



stream , . 4 
object. 



Remarks 
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The grammar must be loaded into the recognizer by calling SrgsGrammar::Commit(); 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Load Method 

Note: This documentation is preliminary and is subject to change. 

Loads an SrgsGrammar class instance from an input/output stream and optionally initializes its 
members. 

Overload List 

public Void Load (Stream, Boolean) 
public Void Load (String, Boolean) 
public Void Load (Stream) 
public Void Load (String) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Save Method 

Note: This documentation is preliminary and is subject to change. 

Saves an SrgsGrammar class instance to the specified universal resource identifier (URI). 

Overload List 

public Void Save (String) 
public Void Save (Stream) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SrgsGrammar Method 

Note: This documentation is preliminary and is subject to change. 
Creates a new SrgsGrammar class instance. 
Overload List 
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public SrgsGrammarO 
public SrgsGranimar (String) 
public SrgsGrammar (IRecognizer) 

Remarks 

The SrgsGrammar object is assigned to the default GrammarGroup for the specified 
Recognizer. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 

Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System.String. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Language Property 



Note: This documentation is preliminary and is subject to change. 

Gets and sets the language of the SrgsGrammar class instance(xml:lang). 

Definition 

Visual Basic Public Property Language As Culturelnfo Class 

C# public Culturelnfo Class Language { get; set; } 

. r public: property Culturelnfo Class * getJLanguageO; 

anage public: property void setLanguagef CuIturelnfo Class *); 



• f public function get LanguageO : Culturelnfo Class 
cn P public function set Languagef Culturelnfo Class ); 
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Property Value 

System.Globalization.CuIturelnfo. 

This property is read/write. 



© 2003 Microsoft C or poration. All rights reserved. Terms of use. 

Mode Property 



Note: This documentation is preliminary and is subject to change. 

Gets and sets the SrgsGrammar grammar mode as either Voice or dual tone, multi-frequency (DTMF). 
Definition 



Visual Basic Public Property Mode As GrammarMode 
C# public GrammarMode Mode { get; set; } 

Mana ed C++ P u ^ c: property GrammarMode get_Mode(); 

g public: property void setMode( GrammarMode) ; 

tc ■ f public function get Mode() : GrammarMode 
p public function set Mode( GrammarMode) : 

Property Value 

System.Speech.Srgs.GrammarMode. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Root Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the root rule of the SrgsGrammar class instance (srgs:root). 

Definition 

Visual Basic Public Property Root As Rule 
C# public Rule Root { get; set; } 

Managed C++ public: — P ro P ert y get_Root(); 

* public: property void set_Root( Rule *); 
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. public function get Root() : Rule 
J Script pubHc ft^Qjj set R 0 ot(Rule); 

Property Value 

System.Speech.Srgs.Rule. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. . 

Rules Property 

Note: This documentation is preliminary and is subject to change. 

Gets the collection of rules that this SrgsGrammar class instance contains. 

Definition 

Visual Basic Public ReadOnly Property Rules As RuleColIection 
C# public RuleColIection Rules { get; } 

Managed C++ public: property RuleColIection * get_Rules(); 

JScript public function get Rules() : RuleColIection 

Property Value 

System.Speech.Srgs.RuleCollection. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TagFormat Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the format of the SrgsGrammar class instance Tag class instance (srgs: tag- format). 
Definition 

Visual Basic Public Property TagFormat As TagFormat 
C# public TagFormat TagFormat { get; set; } 
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public: _property TagFormat get_TagFormat(); 
Managed C++ public: _p roper t y void set TagFormat( TagForinat ): 

public function get TagFormatO : Ta gFormat 
Script public function set TagFormat(TagFonnat); 

Property Value 

System.Speech.Srgs.TagFormat. 
This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

XmlBase Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the base universal resource identifier (URI) of the SrgsGrammar class instance (xmhbase). 
Definition 

Visual Basic Public Property XmlBase As String 

C# public string XmlBase { get; set; } 

r public: property String * get_XmlBase(); 

Managed C++ puh]ic . _p rope rty void set_XmlBase(String*); 

• t public function get XmlBaseO : String 
Script pubUc set XmlBase(String); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SrgsText Class 

Note: This documentation is preliminary and is subject to change. 

Represents text content in Speech Recognition Grammar Specification (SRGS) markup. 

Definition 
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Public Class SrgsText 
Visual Basic Inherits Object 

Implements IltemElement . IRuleElement 

^ public class SrgsText : Object . 

IltemElement IRuleElement 

Managed C++ public — §C ° lasS Sr § sText : P ublic 0b J ect > 
8 IltemElement , IRuleElement 

T ~ . f public class SrgsText extends Object 

p implements IRuleElement. IltemElement 



Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SrgsText 

Class Information 

Namespace System.Speech.Srgs 

Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version^. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SrgsText Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the SrgsText class. 
Overload List 

public SrgsText Q 
public SrgsText (Strin g) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 
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Note: This documentation is preliminary and is subject to change. 
Gets and sets the text of the SrgsText class instance. 
Definition 

Visual Basic Public Property Text As String 
C# public string Text { get; set; } 

Managed C++ pubHc: -P 10 ^ ^ring* get_Text(); 

5 public: property void set_Text( String *); 

to • f public function get TextO ' String 
J^cnpt public ftj^jj set Text(String); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Tag Class 

Note: This documentation is preliminary and is subject to change. . 

Represents the World Wide Web Consortium (W3C) Speech Recognition Grammar Specification 
(SRGS) tag element. See http://www.w3.org/TR/speech-grammar/ for more information. 

Definition 

Public Class Tag 
Visual Basic Inherits Object 

Implements HtemElement . IRuleElement 

public class Tag : Object . 
HtemElement IRuleElement 

Managed C++ publi ° — gC ° laSS Tag : pubHc 0bj ' ect ' 
g HtemElement , IRuleElement 

. public class Tag extends Object 

P implements IRuleElement . HtemElement 

Members Table 
Inheritance Hierarchy 
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fx] Leave 
Object id 



Tag 

Class Information 



Namespace System.Speech.Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Tag Method 



Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the Tag class. 
Overload List 

public Tag 0 
public Tag (String) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 

Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System.String. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the text of the Tag class instance. 

Definition 

Visual Basic Public Property Text As String 
C# public string Text { get; set; } 

Manaapri C++ publiCI _P ro P ert y String* get_Text(); 
ivianagea ^ public: _p roperty void S et_Text(String*); 

to • f public function get TextO : String 
cn ' ) public function set Text(String); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Token Class 



Note: This documentation is preliminary and is subject to change. 

Token represents the World Wide Web Consortium (W3C) Speech Recognition Grammar Specification 
(SRGS) token element. See http://www.w3.org/TR7speech-grammar/ for more information. 

Definition 

Public Class Token 
Visual Basic Inherits Object 

Implements IltemElement . IRuleElement 

public class Token : Object . 
IltemElement IRuleElement 

Man d c++ public _gc class Token : public Object, 
IltemElement , IRuleElement 

. public class Token extends Obj ect 
cn P implements IRuleElement , IltemElement 
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Members Table 
Inheritance Hierarchy 



Object 



x] Leave 



Token 

Remarks 

Note that if multiple words are stored in a single Token, each is treated internally, and in the 
result, as a different token. 

Class Information 

Namespace System. Speech. Srgs 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 1 43bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Token Method 

Note: This documentation is preliminary and is subject to change. 
Initializes a new instance of the Token class. 
Overload List 

public Token 0 
public Token (String) 
public Token (String, String) 

Remarks 

Creates a Token object with properties not yet set. The text property must be set prior to 
committing the associated rule(s) to the Grammar. 

Creates a Token object with the Text property initially set to the text param passed in. , 

Creates a Token class instance with the Text property initially set to the text param passed 
in. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 



Note: This documentation is preliminary and is subject to change. 
Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System.String. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Pronunciation Property 



Note: This documentation is preliminary and is subject to change. 

Gets and sets pronunciation for the token. 

Definition 

Visual Basic Public Property Pronunciation As String 
C# public string Pronunciation { get; set; } 

Managed C++ pubKc: -^ ro P ert y String* get_PronunciationO; 

8 public: property void set_Pronunciation(Strmg*); 

• f public function get PronunciationO : String 
cnp public function set Pronunciation(Strmg); 

Property Value 

System.String. 

This property is read/write. 
Remarks 

This pronunciation is. an extension to the World Wide Web Consortium (W3C) Speech 
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interacting witn me computer using speecn input ana speecn uutpui r-age zso 01 jo / 

Recognition Grammar Specification (SRGS) format using the following namespace: 
http://schemas.microsoftxom/Speech/2002/06/SRGSExtensions 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Text Property 

Note: This documentation is preliminary and is subject to change. 
Gets and sets the text contained within the Token class instance. 
Definition 

Visual Basic Public Property Text As String 
C# public string Text { get; set; } 

Manaeed C++ public: — P ro P ert y get_Text(); 

5 public: property void set_Text(Strmg*); 

^ . public function get TextO : String 
cn P public function set Text( String ); 

Property Value 

System.String. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IltemElement Interface 

Note: This documentation is preliminary and is subject to change. 

The IltemElement interface is an empty interface implemented by all Speech Recognition Grammar 
Specification (SRGS) elements that can be a child element of the item element. (Item, OneOf, RuleRef, 
SpecialRuleRef, Tag, Token, SrgsText) 

Definition 

Visual Basic Public Interface IltemElement 
C# public interface IltemElement 

Managed C++ public gc interface IltemElement 

JScript public interface IltemElement 
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Interface Information 



Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0 5 Culture=neutral, 

Name PublicKeyToken-365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

IRuleElement Interface 

Note: This documentation is preliminary and is subject to change. 

The IRuleElement interface is an empty interface implemented by all Speech Recognition Grammar 
Specification (SRGS) elements that can be a child element of the Rule element. (Example, Item, OneOf, 
RuleRef, SpecialRuleRef, Tag, Token, SrgsText) 

Definition 

Visual Basic Public Interface IRuleElement 
C# public interface IRuleElement 

Managed C++ public gc interface IRuleElement 

JScript public interface IRuleElement 

Interface Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GrammarMode Enumeration 

Note: This documentation is preliminary and is subject to change. 

Identifies the grammar mode as either Voice or dual tone, multi-frequency (DTMF). 

Definition 

Visual Basic Public Enum GrammarMode 
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C# public enum GrammarMode 

Managed C++ value public enum GrammarMode 

JScript public enum GrammarMode 

Constants 

Constant Name Description 

Voice Specifies voice grammar mode. 

Dtmf Specifies dual tone, multi-frequency (DTMF) grammar mode. 

Enumeration Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RuleScope Enumeration 

Note: This documentation is preliminary and is subject to change. 

RuleScope specifies how a rule behaves. The behavior includes whether or not it can be referenced by 
other rules and whether or not the rule can be activated. 

Definition 

Visual Basic Public Enum RuleScope 
C# public enum RuleScope 

Managed C++ value public enum RuleScope 

JScript public enum RuleScope 

Constants 



Constant 
Name 

Public 



Description 

Specifies a Public Rule. Rules identified as Public can be both activated as 
well as referenced by rules in other grammars 

Private Specifies a Private rule. Rules identified as Private cannot be activated, but 
1 1 a e ^ re f erencec [ by rules in the same grammar 

Enumeration Information 
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Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken-365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpecialRuleRefType Enumeration 

Note: This documentation is preliminary and is subject to change. 

Special rule references allow grammars based on context-free grammars (CFG) to have powerful 
additional features, such as transitions into dictation (both recognized or not recognized) and word 
sequences from SAP! 5.0. 

Definition 

Visual Basic Public Enum SpecialRuleRefType 
C# public enum SpecialRuleRefType 

Managed C++ value public enum SpecialRuleRefType 

JScript public enum SpecialRuleRefType 

Constants 

Constant ^ . 

^ T Description 
Name 

^ Specifies a rule that is automatically matched, that is, matched without the 

i J user speaking any word. 

Specifies a rule that can never be spoken. Inserting Void into a sequence 
0i " automatically makes that sequence unspeakable. 

Specifies a rule that may match any speech up until the next rule match, 
r , the next token, or until the end of spoken input. Designed for applications 

° that would like to recognize some phrases without failing due to irrelevant, 

or ignorable words. 

w Specifies a rule that may match recognized speech from an associated text 

^ buffer, or word sequence, on the containing Grammar object. 

Enumeration Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TagFormat Structure 



Note: This documentation is preliminary and is subject to change. 

TagFormat extensible enumeration. 

Definition 

Visual Basic Public Structure TagFormat 
C# public struct TagFormat 

Managed C++ public value struct TagFormat 

JScript In JScript, you can use structures, but you cannot define your own. 

Members Table 
Structure Information 

Namespace System. Speech. Srgs 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture^Tieutral, 

Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Equals Method 

Note: This documentation is preliminary and is subject to change. 
Compares the TagFormat class instance against another object. 
Overload List 

public override Boolean Equals (Object) 
public override Boolean Equals (TagFormat) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetHashCode Method 
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Note: This documentation is preliminary and is subject to change. 
Creates a hash code from the TagFormat class instance string. 
Definition 

Visual Basic Overrides Public Function GetHashCodeO As Integer 

C# public override int GetHashCode(); 
Managed C++ public: int GetHashCode(); 

JScript public override function GetHashCode() : int ; 

Return Value 

System.Int32. 

Returns the hash value of the TagFormat class instance. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

opEquality Method 

Note: This documentation is preliminary and is subject to change. 

TagFormat class equality comparison operator. 

Definition 

Public Shared Function opJE quality ( _ 

Visual Basic ByVal a As Ta g Format > - 
visual Basic ByVa} ft Ag TagFormat _ 

) As Boolean 

public static bool op_Equality( 
r# TagFormat a, 

Ta gFormat b 

); 

public: static bool op_EquaIity( 

Managed C++ TagFormat a, 
Managed C++ TagFormat b 

); 

public static function op_Equality( 
TC . 4 a : TagFormat 
JScn « rt b : TagFormat 

) : boolean : 
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Parameters 

a System.Speech.Srgs.TagFormat. First TagFormat class instance being compared. 
b System.Speech.Srgs.TagFormat. Second TagFormat class instance being compared. 

Return Value 

System.BooIean. 
None. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

op_Inequality Method 

Note: This documentation is preliminary and is subject to change. 

TagFormat class inequality comparison operator. 

Definition 

Public Shared Function op_Inequality( _ 

Visual Basic ByVal a As Ta g Format > - 
Visual uasic ByVa] & . Ag TagFormat 

) As Boolean 

public static bool op_Inequality( 
r „ TagFormat a. 

TagFormat b 

); 

public: static bool op_InequaIity( 

Managed C++ teFormatfl, 
Managed C++ J ^p mm ^ b 

); 

public static function op_Inequality( 
_ e . . a: TagFormat . 
JSm * b : TagVormat 

) : boolean : 

Parameters 

a System.Speech.Srgs.TagFormat. First TagFormat class instance being compared. 
b System.Speech.Srgs.TagFormat. Second TagFormat class instance being compared. 

Return Value 
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System.BooIean. 

None. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

TagFormat Method 



Note: This documentation is preliminary and is subject to change. 

Initializes a new instance of the TagFormat class. 

Definition 

Public Sub TagFormat( _ 
Visual Basic ByVal tagFormat As String _ 
) 

public TagFormat( 
C# string tagFormat 

); 

public: TagFormat( 
Managed C++ String * tagFormat 

public function TagFormat( 
JScript tagFormat : String 

); . 

Parameters 

tagFormat System.String. Format of the new TagFormat class instance. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 



Note: This documentation is preliminary and is subject to change. 
Creates a string representation of this TagFormat class instance. 
Definition 

Visual Basic Overrides Public Function ToStringQ As String 
C# public override string ToStringQ; 
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Managed C++ public: String * ToStringQ; 

JScript public override function ToStringO : String : 

Return Value 

System.String. 

Returns the string representation of the TagFormat class instance. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

DefaultSemantics Property 

Note: This documentation is preliminary and is subject to change. 

Default tag format 

Definition 

Visual Basic Public Shared ReadOnly Property DefaultSemantics As TagFormat 
C# public static TagFormat DefaultSemantics { get; } 

Managed C++ public: property static TagFormat get_DefaultSemantics(); 

JScript public static function get Defaults emanticsO • Ta gFormat 

Property Value 

System.Speech.Srgs.TagFormat. 

This property is read-only. 

© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

MSSapiProperties Property 

Note: This documentation is preliminary and is subject to change. 

Sets the tag format to those described by the Microsoft Speech Applications Programming Interface (MS 
SAPI) Properties 1.0. 

Definition 

Visual Basic Public Shared ReadOnly Property MSSapiProperties As TagFormat 
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C# public static TagFormat MSSapiProperties { get; } 

Managed C++ public: property static TagFormat get_MSSapiProperties(); 

JScript public static function get MSSapiPropertiesO : TagFormat 

Property Value 

System.Speech.Srgs.TagFormat 

This property is read-only. 
Examples 

The following code specifies tag format to be as described by MS SAPI properties. 

// - Add the rule to the grammar and set it as the Root rule . Chang eColorGramma r 

1 - Add the rule to the grammar and set it as the Root rule . ChangeColorGrammar . 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

MSSemanticInterpretation Property 

Note: This documentation is preliminary and is subject to change. 

Sets the tag format to those described by the Microsoft Semantic Interpretation 1.0. 

Definition 

Visual 

Basic Public Shared Readonly Property MSSemanticInterpretation As TagFormat 
C# public static TagFormat MSSemanticInterpretation { get; } 

M (^++ ed public: property static TagFormat getJVISSemantidnterpretationO; 

JScript public static function get MSSemanticInterpretationO : TagFormat 

Property Value 

System.Speech.Srgs.TagFormat. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

System.Speech.Synthesis 
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Note: This documentation is preliminary and is subject to change. 

The following tables list the members exposed by the System. Speech. Synthesis namespace. 

Classes 

AudioLevelChangedEventArgs Provides data for the AudioLevelChanged event. 

BookmarkDetectedEventArgs Error handler 

SpeakCompletedEventArgs [To be provided] 

SpeakProgressChangedEventArgs [To be supplied.] 

SpeakToken Represents a single speak operation. 

SpeechSynthesizer [To be supplied.] 

<v f i -• p t a Event handler for SpeakStarting and future events. Base 

. class for all Speech Synthesis events. 

SynthesizePhonemeEventArgs [To be supplied.] 

Synthesize VisemeEventArgs [To be supplied.] 

Voice [To be supplied.] 

V * Attrih t Represents the attributes of the text-to-speech (TTS) 

voice. 

Enumerations 

SpeakPriority Indicates the speaking priority 
SpeechUnit Specifies the unit of speech. 

VoiceGender Identifies the gender of the voice used in text-to-speech synthesis. 

Structures 

SpeakMediaType SpeakMediaType identifies the format of the content to be spoken. 

Delegates 

a j * t i^u +u ji Represents the method that will handle the 

AudioLevelChangedEventHandler A j- T a 

& : AudioLevelChanged event. 

BookmarkDetectedEventHandler [To be supplied.] 

SpeakCompletedEventHandler [To be supplied.] 

SpeakProgressChangedEventHandler [To be supplied.] 

SynthesisEventHandler [To be supplied.] 

SynthesizePhonemeEventHandler [To be supplied.] 

Synthesize VisemeEventHandler [To be supplied.] 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioLevelChangedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

Provides data for the AudioLevelChanged event. 

Definition 

Visual Public Class AudioLevelChangedEventArgs 
Basic Inherits SynthesisEventArgs 

C# public class AudioLevelChangedEventArgs : SvnthesisEventA ?-gs 

Managed public gc 

C++ class AudioLevelChangedEventArgs : public SvnthesisEventA rgs 

JScript public class AudioLevelChangedEventArgs extends SynthesisEventArg s 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SynthesisEventArg s 

AudioLevelChangedEventArgs 



Class Information 



Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioLevelChangedEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
Sets the audio level for the specified speak operation. 
Definition 
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Public Sub AudioLevelChangedEventArgs( _ 
ByVal speakToken As SpeakToken . _ 
Visual Basic ByVal audioPosition As TimeSpan , _ 
ByVal audioLevel As Integ er _ 

) 

public AudioLeveIChangedEventArgs( 
SpeakToken speakToken, 
C# TimeSpan audioPosition , 

int audioLevel 

); 

public: AudioLevelChangedEventArgs( 
SpeakToken * speakToken, 
Managed C++ TimeSpan audioPosition, 
int audioLevel 

); 

public function AudioLevelChangedEventArgs( 

speakToken : SpeakToken . 
audioPosition : TimeSpan , 
audioLevel : int 

); 



JScript 



Parameters 



speakToken System.Speech.Synthesis.SpeakToken. 
audioPosition System.TimeSpan. 
audioLevel System.Int32. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioLevel Property 

Note: This documentation is preliminary and is subject to change. 

Gets the audio level. 

Definition 

Visual Basic Public ReadOnly Property AudioLevel As Integ er 
C# public int AudioLevel { get; } 

Managed C++ public: property int get_AudioLevel(); 

JScript public function get AudioLevelO : int 

Property Value 

System.Int32. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkDetectedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

Error handler 

Definition 

Tr . ■ . Public Class BookmarkDetectedEventArgs 
Visual Basic T , 0 4l . r , A to 
Inherits SynthesisEventArgs 

C# public class BookmarkDetectedEventArgs : SynthesisEventArgs 

Managed public gc 

C++ class BookmarkDetectedEventArgs : public SynthesisEventArgs 

JScript public class BookmarkDetectedEventArgs extends SynthesisEventArgs 
Members Table 
Inheritance Hierarchy 



Object 



Z! Leave 



SynthesisEventArgs 

BookmarkDetectedEventArgs 



Class Information 



Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong . System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 1 43bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkDetectedEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
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Definition 

Public Sub BookmarkDetectedEventArgs( _ 
ByVal speakToken As S peakToken , _ 
Visual Basic ByVal audioPosition As TimeSpan , _ 
ByVal boohnarkName As String _ 

) 

public BookmarkDetectedEventArgs( 
SpeakToken speakToken, 
C# TimeSpan audioPosition , 

string boohnarkName 

); 

public: BookmarkDetectedEventArgs( 
SpeakToken * speakToken, 
Managed C++ TimeSp an audioPosition, 
String * boohnarkName 

); 

public function BookmarkDetectedEventArgs( 
speakToken : S peakToken . 
JScript audioPosition : TimeSpan , 
boohnarkName : String 

); 

Parameters 

speakToken System.Speech.Synthesis.SpeakToken. 
audioPosition System.TimeSpan. 
boohnarkName System.String. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkName Property 

Note: This documentation is preliminary and is subject to change. 

Gets the name of the Bookmark. 

Definition 

Visual Basic Public ReadOnly Property BookmarkName As String 
C# public string BookmarkName { get; } 

Managed C++ public: property String * getJBookmarkName(); 

JScript public function get BookmarkNameO : String 

Property Value 
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System.String. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakCompletedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

[To be provided] 

Definition 

Public Class SpeakCompletedEventArgs 
Visual Inherits err! bad xref: 

Basic frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic: lookup 
failure; no href; no caption; 

public class SpeakCompletedEventArgs : err! bad xref: 
C# frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic; lookup 
failure; no href; no caption; 

public gc class SpeakCompletedEventArgs : public err! bad xref: 

^ t j frltfSystemComponentModelAsyncCompletedEventArgsClassTopic: lookup 
^ failure; no href; no caption; 

public class SpeakCompletedEventArgs extends err! bad xref: 
JScript frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic: lookup 
failure; no href; no caption; 

Members Table 

Inheritance Hierarchy 

err! bad xref: frlrfSystemComponentModelAsyncCompletedEventArgsClassTopic ; 
lookup failure; no href; no caption; 

SpeakCompletedEventArgs 

Class Information 

Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 1 43bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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SpeakCompletedEventArgs Method 



Note: This documentation is preliminary and is subject to change. 
Event handler that is invoked when a Speak method has concluded. 
Definition 

Public Sub SpeakCompletedEventArgs( _ 

ByVal error As Exception. _ 
Visual Basic ByVal canceled As Boolean , _ 

ByVal speakToken As SpeakToken _ 

) 

public SpeakCompletedEventArgs( 
Exception error, 
C# bool canceled, 

SpeakToken speakToken 

); 

public: SpeakCompIetedEventArgs( 
Exception * error, 
Managed C++ bool canceled, 

SpeakToken * speakToken 

); 

public function SpeakCompIetedEventArgs( 
error : Exception . 
JScript canceled : boolean. 

speakToken : SpeakToken 

); 

Parameters 

error System.Exception. 

canceled System.Boolean. 

speakToken System.Speech.Synthesis.SpeakToken. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakToken Property 



Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 
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Visual Basic Public ReadOnly Property SpeakToken As SpeakToken 
C# public S peakToken SpeakToken { get; } 

Managed C++ public: property SpeakToken * get_SpeakToken(); 

JScript public function get SpeakTokenO : SpeakToken 

Property Value 

System.Speech.Synthesis.SpeakToken. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakProgressChangedEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Public Class SpeakProgressChangedEventArgs 
Basic Inherits SynthesisEventArg s 
C# public class SpeakProgressChangedEventArgs : SynthesisEventArgs 

Managed public gc 

C++ class SpeakProgressChangedEventArgs : public SynthesisEventArgs 

JScript public class SpeakProgressChangedEventArgs extends SynthesisEventA rg s 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SynthesisEventArgs 

SpeakProgressChangedEventArgs 



Class Information 



Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 1 43bb27e7ac8b 
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© 2003 Microsoft Corporation. AH rights reserved. Terms of use. 

SpeakProgressChangedEventArgs Method 

Note: This documentation is preliminary and is subject to change. 
Event handler that is invoked when a Speak method is in progress. 
Definition 

Public Sub SpeakProgressChangedEventArgs( _ 

ByVal speakToken As SpeakToken , _ 
Visual Basic ByVal audioPosition As TimeSpan , _ 
ByVal characterPosition As Integer _ 

) 

public SpeakProgressChangedEventArgs( 
SpeakToken speakToken, 
C# TimeSpan audioPosition, 

int characterPosition 

); 

public: SpeakProgressChangedEventArgs( 
SpeakToken * speakToken, 
Managed C++ m TimeSpan audioPosition, 
int characterPosition 

); 

public function SpeakProgressChangedEventArgs( 

speakToken : SpeakToken , 
JScript audioPosition : TimeSpan , 
characterPosition : mt 

); 

Parameters 

speakToken System.Speech.Synthesis.SpeakToken. 
audioPosition System.TimeSpan. 
characterPosition System.Int32. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CharacterPosition Property 

Note: This documentation is preliminary and is subject to change. 

fi1e://C:\WTNDOWS\TEMP\~hhEEA9.htm 2/3/04 



Interacting with the Computer using Speech Input and Speech Output 



i-'age 314 of 357 



Gets the current character position within text where speech is being synthesized. 
Definition 



Visual Basic Public ReadOnly Property CharacterPosition As Integer 
C# public int CharacterPosition { get; } 

Managed C++ public: property int get_CharacterPosition(); 

JScript public function get CharacterPositionO * int 

Property Value 

System.Int32. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakToken Class 



Note: This documentation is preliminary and is subject to change. 



Represents a single speak operation. 
Definition 



XT . , „ . Public Class SpeakToken 
Visual Basic T , ~, . r . 

Inherits Object 

C# public class SpeakToken : Object 

Managed C++ public gc class SpeakToken : public Object 

JScript public class SpeakToken extends Object 



Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SpeakToken 

Class Information 

Namespace System. Speech. Synthesis 
Assembly System. Speech (system.speech.dll) 

Strong System. Speech, Version=6.0.4044.0, Culture=neutral 5 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Cancel Method 

Note: This documentation is preliminary and is subject to change. 

Cancels a speak operation asynchronously. 

Definition 

Visual Basic Public Sub CancelO 
C# public void CancelO; 
Managed C++ public: void CancelO; 

JScript public function CancelO : void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

ToString Method 

Note: This documentation is preliminary and is subject to change. 
Gets a string representing the content of a speak operation. 
Definition 

Visual Basic Overrides Public Function ToStringO As String 

C# public override string ToStringO; 
Managed C++ public: String * ToStringO; 

JScript public override function ToStringO : String ; 

Return Value 

System. String. 

© 2003 Microsoft Corporation. All rights reserved. r 

SpeechSynthesizer Class 
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Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

i « • Public Class SpeechSynthesizer 
Visual Basic ^ erits ^ 

C# public class SpeechSynthesizer : Object 
Managed C++ public _gc class SpeechSynthesizer : public Object 
JScript public class SpeechSynthesizer extends Object 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SpeechSynthesizer 

Class Information 

Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Clear Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Sub ClearQ 
C# public void Clear(); 
Managed C++ public: void Clear(); 

JScript public function Clear() : void : 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 
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Dispose Method 

Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
Overload List 

public Void Dispose () 
public Void Dispose (Boolean) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Finalize Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Overrides Protected Sub FinalizeO 

C# -SpeechSynthesizerO; 
Managed C++ -SpeechSynthesizerO; 

JScript protected override function FinalizeO : void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Pause Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Sub PauseO 

C# public void PauseO; 
Managed C++ public: void PauseO; 

JScript public function PauseO : void : 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Resume Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Sub ResumeO 
C# public void ResumeO; 
Managed C++ public: void ResumeO; 

JScript public function ResumeO : void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Skip Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Public Function Skip( _ 

Visual Basic ByVal COUnt As Inter ' - 
visual jjasic ByVal ^ Ag SpeechUnit 

) As Integer 
public mt Skip( 

int count, 

SpeechUnit unit 

); 

public: int Skip( 

1%/r j ^ . . int count, 
Managed C++ — 5 

& SpeechUnit unit 

); 

public function Skip( 
. count : int, 

Jbcript unit : SpeechUnit 
) int; 

Parameters 
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count System.Int32. 

unit System.Speech.Synthesis.SpeechUnit. 

Return Value 

System.Int32. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeechSynthesizer Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Sub SpeechSynthesizerO 

C# public SpeechSynthesizerO; 
Managed C++ public: SpeechSynthesizerO; 

JScript public function SpeechSynthesizerO; 

© 2003 Microsoft Corporation . All rights reserved. Terms of use. 

CurrentToken Property 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property CurrentToken As S peakToken 
C# public SpeakToken CurrentToken { get; } 

Managed C++ public: property SpeakToken * getCurrentTokenO; 

JScript public function get CurrentToken() : SpeakToken 

Property Value 

System.Speech.Synthesis.SpeakToken. 

This property is read-only. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

RateMultiplier Property 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Property RateMultiplier As Sing le 

C# public float RateMultiplier { get; set; } 

r public: property float get_RateMultiplier(); 

Managed C++ pnhlic: _p roperty void S et_RateMultiplier (float); 

T e • t public function get RateMultiplierO : float 
P public function set RateMultiplier (float); 

Property Value 

System.Single. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SystemSynthesizer Property 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual 

Basic V^lic Shared ReadOnly Property SystemSynthesizer As SpeechSynthesizer 

C# public static SpeechSynthesizer SystemSynthesizer { get; } 

^C++ P u ^^ c: P ro P ert Y stat i c S peechSynthesizer * getJSystemSynthesizerO; 

JScript public static function get SystemSynthesizerO : SpeechSynthesizer 

Property Value 
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System.Speech.Synthesis.SpeechSynthesizer. 

This property is read-only. 

© 2003 Microsoft Corporation. All ri ghts reserved. Terms of use. 

VolumeMultiplier Property 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Property VolumeMultiplier As Single 
C# public float VolumeMultiplier { get; set; } 

Managed C++ pubUc: — P ro P ert y get_VolumeMultiplier(); 

8 public: property void set_VolumeMultiplier(float); 

„ . f public function get VolumeMultiplierO : float 
p public function set VolumeMultiplier (float); 

Property Value 

System.Single. 

This property is read/write. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioLevelChanged Event 

Note: This documentation is preliminary and is subject to change.. 

[To be supplied.] 

Definition 

Visual Basic Public Event AudioLevelChanged As A udioLevelChangedEventHandler 
C# public event AudioLevelChangedEventHandler AudioLevelChanged; 

Managed C++ public: event AudioLevelChanged; 

JScript In JScript, you can use events, but you cannot define your own: 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SynthesizePhoneme Event 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Event SynthesizePhoneme As SynthesizePhonemeEventHandler 
C# public event SynthesizePhonemeEventHandler SynthesizePhoneme; 

Managed C++ public: event SynthesizePhoneme; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Synthesize Vis erne Event 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Event Synthesize Viseme As Synthesize VisemeEventHandler 
C# public event SynthesizeVisemeEventHandler SynthesizeViseme; 

Managed C++ public: event SynthesizeViseme; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SynthesisEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

Event handler for SpeakStarting and future events. Base class for all Speech Synthesis events. 
Definition 
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. Public Class SynthesisEventArgs 
Visual Basic Ir±eTit$ 0bject 

C# public class SynthesisEventArgs : Object 

Managed C++ public gc class SynthesisEventArgs : public Object 

JScript public class SynthesisEventArgs extends Object 

Members Table 
Inheritance Hierarchy 



Object 



HI Leave 



SynthesisEventArgs 

AudioLevelChangedEventArgs 
BookmarkDetectedEventArgs 
SpeakProgressChangedEventArgs 
SynthesizePhonemeEventArgs 
Synthesize VisemeEventArgs 



Class Information 



Namespace System.Speech.Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=Tieutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SynthesisEventArgs Method 

Note: This documentation is preliminary and is subject to change. 

Event handler for speech synthesis events. 

Definition 

Public Sub SynthesisEventArgs( _ 

_ 7 . . ^ . By Val speakToken As SpeakToken, 
Visual Basic t/,, i j- d * o 

ByVal audioPosition As TimeSp an _ 

) 

public SynthesisEventArgs( 
S peakToken speakToken, 
TimeSp an audioPosition 

); 
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public: SynthesisEventArgs( 
. r SpeakToken * speakToken, 
Managed C++ TimeSpan au dioPosition 

); 

public function SynthesisEventArgs( 
„ . speakToken : SpeakToken . 

Jfccript audioPosition : TimeSpan 

); 



Parameters 



speakToken System.Speech.Synthesis.SpeakToken. 
audioPosition System.TimeSpan. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

AudioPosition Property 

Note: This documentation is preliminary and is subject to change. 

Gets the position within the spoken text at which the synthesis event occurred. 

Definition 

Visual Basic Public ReadOnly Property AudioPosition As TimeSpan 
C# public TimeSpan AudioPosition { get; } 

Managed C++ public: property TimeSpan get_AudioPosition(); 

JScript public function get AudioPositionO : TimeSpan 

Property Value 

System.TimeSpan . 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakToken Property 

Note: This documentation is preliminary and is subject to change. 
Gets the identity of the Speak method call that raised the synthesis event. 
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Definition 

Visual Basic Public ReadOnly Property SpeakToken As SpeakToken 
C# public SpeakToken SpeakToken { get; } 

Managed C++ public: property SpeakToken * getjSpeakTokenO; 

JScript public function get SpeakTokenO : SpeakToken 

Property Value 

System.Speech.Synthesis.SpeakToken. 

This property is read-only. 



© 2003 Microsoft Corporation, All rights reserved. Terms of use. 

SynthesizePhonemeEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic ^ u ^^ c Class SynthesizePhonemeEventArgs 

Inherits Synthesis EventArgs 

C# public class SynthesizePhonemeEventArgs : SynthesisEventArgs 

Managed public gc 

C++ class SynthesizePhonemeEventArgs : public SynthesisEventA rg s 

JScript public class SynthesizePhonemeEventArgs extends SynthesisEventArgs 
Members Table 
Inheritance Hierarchy 



Object 



fx] Leave 



SynthesisEventArgs 

SynthesizePhonemeEventArgs 



Class Information 



Namespace System.Speech.Synthesis 
Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
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Name PublicKeyToken=365 143bb27e7ac8b 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SynthesizePhonemeEventArgs Method 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Public Sub SynthesizePhonemeEventArgs( _ 

ByVal speakToken As SpeakToken , _ 

ByVal audioPosition As TimeSpan , _ 
Visual Basic ByVal currentPhoneme As Integ er, _ 
t i ByVal duration As TimeSpan , _ 

ByVal features As Integer , _ 

ByVal nextPhoneme As Integer _ 

) 

public SynthesizePhonemeEventArgs( 
SpeakToken speakToken, 
TimeSpan audioPosition, 
int currentPhoneme, 
TimeSpan duration, 
int features, 
int nextPhoneme 

); 

public: SynthesizePhonemeEventArgs( 
SpeakToken * speakToken, 
TimeSp an audioPosition, 

Mana ed C++ ~ currentPhoneme, 
■* TimeSpan duration, 

int features, 
int nextPhoneme 

); 

public function SynthesizePhonemeEventArgs( 

speakToken : SpeakToken , 
audioPosition : TimeSp an. 
j« . currentPhoneme : int, 

! P duration : TimeSpan , 

features : int , 
nextPhoneme : int 

); 

Parameters 
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speakToken System.Speech.Synthesis.SpeakToken. 
audioPosition System.TimeSpan. 
currentPhoneme System.Int32. 
duration System.TimeSpan. 
features System.Int32. 
nextPhoneme System.Int32. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CurrentPhoneme Property 



Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property CurrentPhoneme As Integer 
C# public int CurrentPhoneme { get; } 

Managed C++ public: property int getCurrentPhonemeQ; 

JScript public function get CurrentPhonemeO ■ int 

Property Value 

System.Int32. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Duration Property 



Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property Duration As TimeSpan 

C# public TimeSpan Duration { get; } 
Managed C++ public: property TimeSpan getJDurationQ; 
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JScript public function get Duration() : TimeSp an 

Property Value 

System.TimeSpan. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

NextPhoneme Property 



Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property NextPhoneme As Integer 
C# public tat NextPhoneme { get; } 

Managed C++ public: property tat get_NextPhoneme(); 

JScript public function get NextPhonemeO : int 

Property Value 

System.Int32. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Synthesize VisemeEventArgs Class 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic ^ u ^^ c Class Synthesize VisemeEventArgs 

Inherits SynthesisEventArgs 

C# public class Synthesize VisemeEventArgs : SynthesisEventArgs 
fifft://C:\WTNDOWS\TEMPV-hhEEA9.Hm ~~ * 2/3/04 
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Managed public gc 

C++ class SynthesizeVisemeEventArgs : public SynthesisEventArgs 

JScript public class SynthesizeVisemeEventArgs extends SynthesisEventAr gs 

Members Table 
Inheritance Hierarchy 



Object 



0 Leave 



SynthesisEventArgs 

SynthesizeVisemeEventArgs 



Class Information 



Namespace System. Speech. Synthesis 
Assembly System. Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SynthesizeVisemeEventArgs Method 



Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 



Visual Basic 



C# 



Public Sub Synthesize VisemeEventArgs( 

ByVal speakToken As SpeakToken , _ 
ByVal audioPosition As TimeSpan . _ 
ByVal currentViseme As Integ er. _ 
ByVal duration As TimeSpan , _ 
ByVal features As Integer . _ 
ByVal nextViseme As Integer _ 

) 

public Synthesize VisemeEventArgs( 
SpeakToken speakToken, 
TimeSpan audioPosition, 
int currentViseme, 
TimeSpan duration, 
int features, 
int nextViseme 
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); 

public: Synthesize VisemeEventArgs( 
S peakToken * speakToken, 
TimeSpan audioPosition, 

Man a ed C++ ~ currentViseme, 
* TimeSpan duration, 

int features, 
int nextViseme 

); 

public function Synth esizeVisemeEventArgs( 
speakToken : S peakToken , 
audioPosition : TimeSpan , 
„ . currentViseme : int, 

P duration : TimeSpan , 

features : int, 
nextViseme : int 

); 



Parameters 



speakToken System.Speech.Synthesis.SpeakToken. 

audioPosition System.TimeSpan . 

currentViseme System.Int32. 

duration System.TimeSpan. 

features System.Int32. 

next Viseme System.Int32 . 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CurrentViseme Property 



Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property CurrentViseme As Integer 
C# public int CurrentViseme { get; } 

Managed C++ public: property int get_CurrentViseme(); 

JScript public function get CurrentVisemeQ : int 



Property Value 
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System.Int32. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Duration Property 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property Duration As TimeSpan 
C# public TimeSpan Duration { get; } 

Managed C++ public: property TimeSpan get_Duration(); 

JScript public function get DurationO : TimeSpan 

Property Value 

System.TimeSpan. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

NextViseme Property 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public ReadOnly Property NextViseme As Integer 
C# public int NextViseme { get; } 

Managed C++ public: property int get_NextViseme(); 

JScript public function get NextVisemeQ : int 

Property Value 
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System.Int32. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Voice Class 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Public Class Voice 
Visual Basic Inherits Object 

Implements IDisposable 

public class Voice : Object . 
IDisposable 

ManaaPrt T++ P Ublk — gC daSS V ° iCe : PUbUC 0 b J ect > 

Managed C++ nDisppgable 

K . public class Voice extends Object 
P implements IDisposable 

Members Table 
Inheritance Hierarchy 



Object 



fx] Leave 



Voice 

Class Information 



Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 

Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

CancelSpeakAsync Method 



file://C:\WINDOWS\TEMP\^KKEEA9.htm 



Interacting with the Computer using Speech Input and Speech Output rage 333 of 357 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Public Sub CancelSpeakAsync( _ 
Visual Basic ByVal token As SpeakToken _ 

) 

public void CancelSpeakAsync( 
C# SpeakToken token 

); 

public: void CancelSpeakAsync( 
Managed C++ SpeakToken * token 

public function CancelSpeakAsync( 
JScript token : SpeakToken 
) : void ; 

Parameters 

token System.Speech.Synthesis.SpeakToken. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Dispose Method 



Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
Overload List 

public Void Dispose 0 
public Void Dispose (Boolean) 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Finalize Method 



Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
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Definition 

Visual Basic Overrides Protected Sub Finalize() 

C# ~Voice(); 
Managed C++ -VoiceQ; 

JScript protected override function FinalizeO ' void ; 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Speak Method 

Note: This documentation is preliminary and is subject to change. 
Speaks the specified text using text-to-speech (TTS). 
Overload List 

public Void Speak (String) 

public Void Speak (String, SpeakMediaType) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakAsync Method 

Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
Overload List 

public SpeakToken SpeakAsync (String) 

public SpeakToken SpeakAsync (String, SpeakMediaType) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakFile Method 

Note: This documentation is preliminary and is subject to change. 
Speaks the contents of the specified file. 
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Overload List 

public Void SpeakFile (String) 

public Void SpeakFile (String. SpeakMediaTvpe) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakFileAsync Method 

Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
Overload List 

public SpeakToken SpeakFileAsync (Strin g) 

public SpeakToken SpeakFileAsync (String. SpeakMediaType) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Voice Method 

Note: This documentation is preliminary and is subject to change. 
[To be supplied.] 
Overload List 

public Voice 0 

public Voice (Voice Attributes) 
public Voice (VoiceAttributes, SpeechSynthesizer) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Attributes Property 

Note: This documentation is preliminary and is subject to change. 
Gets the attributes describing the characteristics of the voice. 
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Definition 

Visual Basic Public ReadOnly Property Attributes As VoiceAttributes 
C# public VoiceAttributes Attributes { get; } 

Managed C++ public: property VoiceAttributes * get_Attributes(); 

JScript public function get AttributesO : VoiceAttributes 

Property Value 

System.Speech.Synthesis.VoiceAttributes. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Priority Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the speaking priority of the text. 

Definition 

Visual Basic Public Property Priority As SpeakPriority 
C# public SpeakPriority Priority { get; set; } 

tvi »n »opH r++ P ublic: _P ro P ert y S peakPriority get PriorityO; 
ivianagea public . _p roperty void se t Priority (SpeakPriority); 

to • t public function get PriorityO : S peakPriority 
JScript public function set PriorityrS peakPriority) ; 

Property Value 

System.Speech.Synthesis.SpeakPriority. 

This property is read/write. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Rate Property 

Note: This documentation is preliminary and is subject to change. 
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Gets and sets the rate of speech used in text-to-speech (TTS) synthesis. 
Definition 

Visual Basic Public Property Rate As Single 

C# public float Rate { get; set; } 

ivT h n P ub li c: property float get_Rate(); 

Managed C++ piMc; _p roperty void se t_Rate(float): 

K . public function get Rate() : float 
p public function set Rate(float); 

Property Value 

System.Single. 

This property is read/write. 
Remarks 

Rate must be a floating point value greater than zero. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Synthesizer Property 

Note: This documentation is preliminary and is subject to change. 
Gets and Sets the synthesizer where the voice is to be used. 
Definition 

Visual Basic Public Property Synthesizer As S peechSynthesizer 
C# public SpeechSynthesizer Synthesizer { get; set; } 

M , r public: property SpeechSynthesizer * get_Synthesizer(); 

anage public: property void set Synthesizer( SpeechSynthesizer *); 

to • f public function get Synthesizer() : SpeechSynthesizer 
cn P public function set Synthesizer (SpeechSynthesizer ); 

Property Value 

System.Speech.Synthesis.SpeechSynthesizer. 

This property is read/write. 
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© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Volume Property 

Note: This documentation is preliminary and is subject to change. 
Gets and sets the volume level of text-to-speech (TTS) synthesis. 
Definition 

Visual Basic Public Property Volume As Single 
C# public float Volume { get; set; } 

Managed C++ public: -^ ro P ert y get_Volume(); 
managed puV&c . _p ropert y vo id S et_Volume(float); 

• f public function get Volume() : float 
P public function set Volume(float); 

Property Value 

System.Single. 

This property is read/write. 
Remarks 

The value of Volume must be a floating point number between 0 and 100. 
© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

BookmarkDetected Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when a bookmark is detected. 

Definition 

Visual Basic Public Event BookmarkDetected As BookmarkDetectedEventHandler 
C# public event BookmarkDetectedEventHandler BookmarkDetected; 

Managed C++ public: event BookmarkDetected; 

JScript In JScript, you can use events, but you cannot define your own. 
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SpeakCompleted Event 

Note: This documentation is preliminary and is subject to change. 

[To be supplied.] 

Definition 

Visual Basic Public Event SpeakCompleted As SpeakCompletedEventHandler 
C# public event SpeakCompletedEventHandler SpeakCompleted; 

Managed C++ public: event SpeakCompleted; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakProgressChanged Event 

Note: This documentation is preliminary and is subject to change. 

Occurs when speech in progress has changed, that is, each instance that change in speech is taking place. 
Definition 

Visual Public 

Basic Event SpeakProgressChanged As SpeakProgressChangedEventHandler 
C# public event SpeakProgressChangedEventHandler SpeakProgressChanged; 

^ 6C * Public: event SpeakProgressChanged; 

JScript In JScript, you can use events, but you cannot define your own. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakStarting Event 

Note: This documentation is preliminary and is subject to change. 

Event that occurs when speaking has begun. 

Definition 
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Visual Basic Public Event SpeakStarting As SynthesisEventHandler 
C# public event SynthesisEventHandler SpeakStarting; 

Managed C++ public: event SpeakStarting; 

JScript In JScript, you can use events, but you cannot define your own. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

VoiceAttributes Class 



Note: This documentation is preliminary and is subject to change. 
Represents the attributes of the text-to-speech (TTS) voice. 
Definition 

- 7 . in . Public Class VoiceAttributes 
Visual Basic T u ^, . . 

Inherits Object 

C# public class VoiceAttributes : Object 

Managed C++ public gc class VoiceAttributes : public Object 

JScript public class VoiceAttributes extends Object 



Members Table 
Inheritance Hierarchy 



Object 



3 Leave 



VoiceAttributes 

Class Information 

Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Age Property 

Note: This documentation is preliminary and is subject to change. 
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Gets and sets the approximate age of the voice used in text-to-speech (TTS) synthesis. Optional. 
Definition 

Visual Basic Public Readonly Property Age As Integer 
C# public int Age { get; } 

Managed C++ public: property int get_Age(); 

JScript public function get Age() : int 

Property Value 

System.Int32. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Gender Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the gender of the voice used in text-to-speech (TTS) synthesis.Optional. 

Definition 

Visual Basic Public ReadOnly Property Gender As VoiceGender 
C# public VoiceGender Gender { get; } 

Managed C++ public: property VoiceGender get_Gender(); 

JScript public function get GenderO : VoiceGender 

Property Value 

System.Speech.Synthesis.VoiceGender. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Languages Property 

Note: This documentation is preliminary and is subject to change 
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Gets and sets cultural information about the voice used with text-to-speech (TTS) synthesis. 
Definition 

Visual Basic Public Readonly Property Languages As Culturelnfo Class Q 
C# public Culturelnfo Class [] Languages { get; } 

Managed C++ public: property Culturelnfo Class * get_Languages(); 

JScript public function get LanguagesQ : Culturelnfo CIass [] 

Property Value 

System.Globalization.Culturelnfo. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Name Property 

Note: This documentation is preliminary and is subject to change. 

Gets and sets the platform-specific voice name used in text-to-speech (TTS) synthesis. Optional. 
Definition 

Visual Basic Public ReadOnly Property Name As String 
C# public string Name { get; } 

Managed C++ public: property String * getJVameO; 

JScript public function get Name() : String 

Property Value 

System.String. 

This property is read-only. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Vendor Property 

Note: This documentation is preliminary and is subject to change. 
file://C:WINDOWS\TEMP\~hhEEA9.htm 



2/3/04 



Interacting with the Computer using Speech input and speech Output 



Page 343 of 35 / 



Gets the name of the vendor of the voice used with text-to-speech (TTS) synthesis. 
Definition 

Visual Basic Public ReadOnly Property Vendor As String 
C# public string Vendor { get; } 

Managed C++ public: property String * get_Vendor(); 

JScript public function get VendorQ " String 

Property Value 

System.String. 

This property is read-only. 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakPriority Enumeration 



Note: This documentation is preliminary and is subject to change. 

Indicates the speaking priority 

Definition 

Visual Basic Public Enum SpeakPriority 
C# public enum SpeakPriority 

Managed C++ value public enum SpeakPriority 

JScript public enum SpeakPriority 

Constants 

Constant Name Description 

Normal Specifies that speech has normal priority. 

High Specifies that speech has high priority. 

Enumeration Information 



Namespace System. Speech. Synthesis 

Assembly System.Speech (system.speech.dll) 

Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 
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Note: This documentation is preliminary and is subject to change. 

Specifies the unit of speech. 

Definition 



Visual Basic Public Enum SpeechUnit 
C# public enum SpeechUnit 

Managed C++ value public enum SpeechUnit 

JScript public enum SpeechUnit 

Constants 



Constant 
Name 

Sample 

Phoneme 

Word 

Sentence 

Paragraph 

Document 



Description 

Specifies that the unit of speech is one recorded analog value in a sound 
file. 

Specifies that the unit of speech is a phoneme. 
Specifies that the unit of speech is a word. 
Specifies that the unit of speech is a sentence. 
Specifies that the unit of speech is a paragraph. 
Specifies that the unit of speech is a document. 



Enumeration Information 

Namespace System. Speech. Synthesis 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=neutral, 
Name PublicKeyToken=365 143bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

VoiceGender Enumeration 



Note: This documentation is preliminary and is subject to change. 
Identifies the gender of the voice used in text-to-speech synthesis. 
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Definition 



Visual Basic Public Enum VoiceGender 
C# public enum VoiceGender 

Managed C++ value public enum VoiceGender 

JScript public enum VoiceGender 



Constants 



Constant 
Name 



Description 



Neutral Specifies that the spoken voice used for text-to-speech (TTS) synthesis is 

1 N u * 411 gender neutral. 

Male Specifies that the voice used for text-to-speech (TTS) synthesis is male. 

Female Specifies that the voice used for text-to-speech (TTS) synthesis is female. 

Enumeration Information 

Namespace System.Speech.Synthesis 
Assembly System.Speech (system.speech.dll) 
Strong System.Speech, Version=6.0.4044.0, Culture=Tieutral, 
Name PublicKeyToken=3 65 1 43bb27e7ac8b 



© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

SpeakMediaType Structure 

Note: This documentation is preliminary and is subject to change. 
SpeakMediaType identifies the format of the content to be spoken. 
Definition 

Visual Basic Public Structure SpeakMediaType 
C# public struct SpeakMediaType 

Managed C++ public value struct SpeakMediaType 

JScript In JScript, you can use structures, but you cannot define your own. 

Members Table 

Structure Information 

Namespace System.Speech.Synthesis 
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Assembly System. Speech (system.speech.dll) 
Strong System.Speech, Version=6. 0.4044.0, Culture=neutral, 
Name PublicKeyToken=365143bb27e7ac8b 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

Equals Method 

Note: This documentation is preliminary and is subject to change. 

Returns true if the specified object is a SpeakMediaType struct, and if it matches the media type of the 
current instance. 

Overload List 

public override Boolean Equals (Object) 

public override Boolean Equals (SpeakMediaType) 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

GetHashCode Method 

Note: This documentation is preliminary and is subject to change. 

Returns the hash code for this instance. 

Definition 

Visual Basic Overrides Public Function GetHashCode() As Integ er 

C# public override int GetHashCodeO; 
Managed C++ public: int GetHashCodeO; 

JScript public override function GetHashCodeO ' int : 

Return Value 

System.Int32. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use. 

opEquality Method 
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Note: This documentation is preliminary and is subject to change. 

Indicates that the two instances are equal. 

Definition 

Public Shared Function op_Equality( _ 

. . R . ByVal a As SpeakMediaTyp e,, _ 
Visual Basic ByVal b A§ S peakMediaT yp e _ 

) As Boolean 

public static bool op_Equality( 
p„ SpeakMediaType a, 

SpeakMediaType b 

); 

public: static bool op_EquaIity( 

Managed C++ SpeakMediaType a, 
Managed C++ SpeakMediaTvpe b 

); 

public static function op_Equality( 
Q . a : SpeakMediaType . 

^ cnp b : SpeakMediaType 

) : boolean : 

Parameters 

a System.Speech.Synthesis.SpeakMediaType. 
b System.Speech.Synthesis.SpeakMediaType. 

Return Value 

System.Boolean. 

© 2003 Microsoft Corporation. All rights reserved. Terms of use, 

oplnequality Method 

Note: This documentation is preliminary and is subject to change. 

Indicates that the two instances are not equal. 

Definition 

Public Shared Function op_Inequality( _ 
Visual Basic ByVal a As SpeakMediaType , _ 
ByVal b As S peakMedis 
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